rhai/src/engine.rs

2286 lines
86 KiB
Rust
Raw Normal View History

2020-03-08 12:54:02 +01:00
//! Main module defining the script evaluation `Engine`.
2016-02-29 22:43:45 +01:00
use crate::any::{map_std_type_name, Dynamic, Union, Variant};
use crate::fn_call::run_builtin_op_assignment;
2020-10-11 15:58:11 +02:00
use crate::fn_native::{Callback, FnPtr, OnVarCallback};
2020-07-26 09:53:22 +02:00
use crate::module::{Module, ModuleRef};
2020-04-10 06:16:39 +02:00
use crate::optimize::OptimizationLevel;
2020-07-05 09:23:51 +02:00
use crate::packages::{Package, PackagesCollection, StandardPackage};
use crate::parser::{Expr, ReturnType, Stmt};
2020-06-29 17:55:28 +02:00
use crate::r#unsafe::unsafe_cast_var_name_to_lifetime;
2020-03-04 15:00:01 +01:00
use crate::result::EvalAltResult;
2020-04-27 16:49:09 +02:00
use crate::scope::{EntryType as ScopeEntryType, Scope};
2020-10-11 15:58:11 +02:00
use crate::syntax::CustomSyntax;
use crate::token::Position;
2020-10-10 07:41:55 +02:00
use crate::{calc_fn_hash, StaticVec};
#[cfg(not(feature = "no_index"))]
use crate::parser::INT;
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_module"))]
use crate::module::ModuleResolver;
#[cfg(not(feature = "no_std"))]
#[cfg(not(feature = "no_module"))]
use crate::module::resolvers;
#[cfg(any(not(feature = "no_object"), not(feature = "no_module")))]
use crate::utils::ImmutableString;
2020-08-03 06:10:20 +02:00
#[cfg(not(feature = "no_closure"))]
2020-07-31 16:30:23 +02:00
#[cfg(not(feature = "no_object"))]
2020-07-31 12:06:01 +02:00
use crate::any::DynamicWriteLock;
2020-03-17 19:26:11 +01:00
use crate::stdlib::{
2020-10-05 07:45:57 +02:00
any::type_name,
2020-03-17 19:26:11 +01:00
boxed::Box,
2020-07-05 09:23:51 +02:00
collections::{HashMap, HashSet},
2020-07-13 13:38:50 +02:00
fmt, format,
iter::{empty, once},
2020-10-12 11:00:58 +02:00
num::NonZeroUsize,
2020-08-02 07:33:51 +02:00
ops::DerefMut,
2020-03-17 19:26:11 +01:00
string::{String, ToString},
vec::Vec,
2020-03-10 03:07:44 +01:00
};
2020-07-31 16:30:23 +02:00
#[cfg(not(feature = "no_index"))]
use crate::stdlib::any::TypeId;
2020-08-03 06:10:20 +02:00
#[cfg(not(feature = "no_closure"))]
use crate::stdlib::mem;
2020-05-15 15:40:54 +02:00
/// Variable-sized array of `Dynamic` values.
2020-04-03 13:42:01 +02:00
///
/// Not available under the `no_index` feature.
#[cfg(not(feature = "no_index"))]
pub type Array = Vec<Dynamic>;
2020-03-04 15:00:01 +01:00
2020-07-03 11:19:55 +02:00
/// Hash map of `Dynamic` values with `ImmutableString` keys.
2020-04-03 13:42:01 +02:00
///
/// Not available under the `no_object` feature.
#[cfg(not(feature = "no_object"))]
pub type Map = HashMap<ImmutableString, Dynamic>;
2020-03-29 17:53:35 +02:00
2020-10-03 12:49:11 +02:00
/// _[INTERNALS]_ A stack of imported modules.
/// Exported under the `internals` feature only.
///
/// ## WARNING
///
/// This type is volatile and may change.
2020-10-02 12:52:18 +02:00
//
// Note - We cannot use &str or Cow<str> here because `eval` may load a module
// and the module name will live beyond the AST of the eval script text.
// The best we can do is a shared reference.
pub type Imports = Vec<(ImmutableString, Module)>;
#[cfg(not(feature = "unchecked"))]
2020-04-07 17:13:47 +02:00
#[cfg(debug_assertions)]
2020-10-21 04:10:46 +02:00
pub const MAX_CALL_STACK_DEPTH: usize = 8;
#[cfg(not(feature = "unchecked"))]
#[cfg(debug_assertions)]
pub const MAX_EXPR_DEPTH: usize = 32;
#[cfg(not(feature = "unchecked"))]
#[cfg(not(feature = "no_function"))]
#[cfg(debug_assertions)]
pub const MAX_FUNCTION_EXPR_DEPTH: usize = 16;
2020-04-07 17:13:47 +02:00
#[cfg(not(feature = "unchecked"))]
2020-04-07 17:13:47 +02:00
#[cfg(not(debug_assertions))]
pub const MAX_CALL_STACK_DEPTH: usize = 128;
#[cfg(not(feature = "unchecked"))]
#[cfg(not(debug_assertions))]
pub const MAX_EXPR_DEPTH: usize = 128;
#[cfg(not(feature = "unchecked"))]
#[cfg(not(feature = "no_function"))]
#[cfg(not(debug_assertions))]
pub const MAX_FUNCTION_EXPR_DEPTH: usize = 32;
2020-04-07 17:13:47 +02:00
2020-04-01 03:51:33 +02:00
pub const KEYWORD_PRINT: &str = "print";
pub const KEYWORD_DEBUG: &str = "debug";
pub const KEYWORD_TYPE_OF: &str = "type_of";
pub const KEYWORD_EVAL: &str = "eval";
2020-06-29 17:55:28 +02:00
pub const KEYWORD_FN_PTR: &str = "Fn";
2020-06-25 12:07:57 +02:00
pub const KEYWORD_FN_PTR_CALL: &str = "call";
2020-07-22 17:12:09 +02:00
pub const KEYWORD_FN_PTR_CURRY: &str = "curry";
2020-10-03 10:25:58 +02:00
#[cfg(not(feature = "no_closure"))]
2020-07-31 12:43:34 +02:00
pub const KEYWORD_IS_SHARED: &str = "is_shared";
2020-10-03 10:25:58 +02:00
pub const KEYWORD_IS_DEF_VAR: &str = "is_def_var";
pub const KEYWORD_IS_DEF_FN: &str = "is_def_fn";
2020-06-26 04:39:18 +02:00
pub const KEYWORD_THIS: &str = "this";
2020-06-25 05:07:46 +02:00
pub const FN_TO_STRING: &str = "to_string";
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_object"))]
2020-06-25 05:07:46 +02:00
pub const FN_GET: &str = "get$";
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_object"))]
2020-06-25 05:07:46 +02:00
pub const FN_SET: &str = "set$";
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_index"))]
2020-07-09 13:54:28 +02:00
pub const FN_IDX_GET: &str = "index$get$";
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_index"))]
2020-07-09 13:54:28 +02:00
pub const FN_IDX_SET: &str = "index$set$";
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_function"))]
2020-07-19 11:14:55 +02:00
pub const FN_ANONYMOUS: &str = "anon$";
2020-07-09 13:54:28 +02:00
pub const MARKER_EXPR: &str = "$expr$";
pub const MARKER_BLOCK: &str = "$block$";
pub const MARKER_IDENT: &str = "$ident$";
2020-03-03 10:28:38 +01:00
/// A type specifying the method of chaining.
2020-07-26 09:53:22 +02:00
#[cfg(any(not(feature = "no_index"), not(feature = "no_object")))]
#[derive(Debug, Clone, Copy, Eq, PartialEq, Hash)]
pub enum ChainType {
2020-06-25 05:07:46 +02:00
None,
Index,
Dot,
}
2020-10-15 17:30:30 +02:00
#[cfg(any(not(feature = "no_index"), not(feature = "no_object")))]
#[derive(Debug, Clone)]
pub enum IndexChainValue {
None,
FnCallArgs(StaticVec<Dynamic>),
Value(Dynamic),
}
#[cfg(any(not(feature = "no_index"), not(feature = "no_object")))]
impl IndexChainValue {
/// Return the `Dynamic` value.
///
/// # Panics
///
/// Panics if not `IndexChainValue::Value`.
#[cfg(not(feature = "no_index"))]
2020-10-15 17:30:30 +02:00
pub fn as_value(self) -> Dynamic {
match self {
Self::None | Self::FnCallArgs(_) => panic!("expecting IndexChainValue::Value"),
Self::Value(value) => value,
}
}
/// Return the `StaticVec<Dynamic>` value.
///
/// # Panics
///
/// Panics if not `IndexChainValue::FnCallArgs`.
#[cfg(not(feature = "no_object"))]
2020-10-15 17:30:30 +02:00
pub fn as_fn_call_args(self) -> StaticVec<Dynamic> {
match self {
Self::None | Self::Value(_) => panic!("expecting IndexChainValue::FnCallArgs"),
Self::FnCallArgs(value) => value,
}
}
}
#[cfg(any(not(feature = "no_index"), not(feature = "no_object")))]
impl From<StaticVec<Dynamic>> for IndexChainValue {
fn from(value: StaticVec<Dynamic>) -> Self {
Self::FnCallArgs(value)
}
}
#[cfg(any(not(feature = "no_index"), not(feature = "no_object")))]
impl From<Dynamic> for IndexChainValue {
fn from(value: Dynamic) -> Self {
Self::Value(value)
}
}
2020-04-26 12:04:07 +02:00
/// A type that encapsulates a mutation target for an expression with side effects.
2020-06-06 07:06:00 +02:00
#[derive(Debug)]
pub enum Target<'a> {
2020-04-26 12:04:07 +02:00
/// The target is a mutable reference to a `Dynamic` value somewhere.
Ref(&'a mut Dynamic),
/// The target is a mutable reference to a Shared `Dynamic` value.
2020-07-31 12:06:01 +02:00
/// It holds both the access guard and the original shared value.
2020-08-03 06:10:20 +02:00
#[cfg(not(feature = "no_closure"))]
2020-07-31 16:30:23 +02:00
#[cfg(not(feature = "no_object"))]
LockGuard((DynamicWriteLock<'a, Dynamic>, Dynamic)),
2020-04-26 12:04:07 +02:00
/// The target is a temporary `Dynamic` value (i.e. the mutation can cause no side effects).
2020-05-16 05:42:56 +02:00
Value(Dynamic),
2020-04-26 12:04:07 +02:00
/// The target is a character inside a String.
/// This is necessary because directly pointing to a char inside a String is impossible.
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_index"))]
2020-05-16 05:42:56 +02:00
StringChar(&'a mut Dynamic, usize, Dynamic),
2020-03-30 16:19:37 +02:00
}
2020-10-11 15:58:11 +02:00
impl<'a> Target<'a> {
2020-05-16 05:42:56 +02:00
/// Is the `Target` a reference pointing to other data?
2020-10-04 04:40:44 +02:00
#[allow(dead_code)]
2020-08-08 10:24:10 +02:00
#[inline(always)]
2020-05-16 05:42:56 +02:00
pub fn is_ref(&self) -> bool {
match self {
2020-06-06 07:06:00 +02:00
Self::Ref(_) => true,
2020-08-03 06:10:20 +02:00
#[cfg(not(feature = "no_closure"))]
2020-07-31 16:30:23 +02:00
#[cfg(not(feature = "no_object"))]
Self::LockGuard(_) => true,
2020-07-26 09:53:22 +02:00
Self::Value(_) => false,
#[cfg(not(feature = "no_index"))]
Self::StringChar(_, _, _) => false,
2020-06-06 07:06:00 +02:00
}
}
/// Is the `Target` an owned value?
2020-10-04 04:40:44 +02:00
#[allow(dead_code)]
2020-08-08 10:24:10 +02:00
#[inline(always)]
2020-06-06 07:06:00 +02:00
pub fn is_value(&self) -> bool {
match self {
Self::Ref(_) => false,
2020-08-03 06:10:20 +02:00
#[cfg(not(feature = "no_closure"))]
2020-07-31 16:30:23 +02:00
#[cfg(not(feature = "no_object"))]
Self::LockGuard(_) => false,
2020-06-06 07:06:00 +02:00
Self::Value(_) => true,
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_index"))]
2020-06-06 07:06:00 +02:00
Self::StringChar(_, _, _) => false,
2020-05-16 05:42:56 +02:00
}
}
2020-07-31 16:30:23 +02:00
/// Is the `Target` a shared value?
2020-10-04 04:40:44 +02:00
#[allow(dead_code)]
2020-08-08 10:24:10 +02:00
#[inline(always)]
2020-07-31 16:30:23 +02:00
pub fn is_shared(&self) -> bool {
match self {
Self::Ref(r) => r.is_shared(),
2020-08-03 06:10:20 +02:00
#[cfg(not(feature = "no_closure"))]
2020-07-31 16:30:23 +02:00
#[cfg(not(feature = "no_object"))]
Self::LockGuard(_) => true,
Self::Value(r) => r.is_shared(),
#[cfg(not(feature = "no_index"))]
Self::StringChar(_, _, _) => false,
}
}
/// Is the `Target` a specific type?
2020-07-26 09:53:22 +02:00
#[allow(dead_code)]
2020-08-08 10:24:10 +02:00
#[inline(always)]
pub fn is<T: Variant + Clone>(&self) -> bool {
match self {
Target::Ref(r) => r.is::<T>(),
2020-08-03 06:10:20 +02:00
#[cfg(not(feature = "no_closure"))]
2020-07-31 16:30:23 +02:00
#[cfg(not(feature = "no_object"))]
Target::LockGuard((r, _)) => r.is::<T>(),
Target::Value(r) => r.is::<T>(),
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_index"))]
Target::StringChar(_, _, _) => TypeId::of::<T>() == TypeId::of::<char>(),
}
}
2020-05-16 05:42:56 +02:00
/// Get the value of the `Target` as a `Dynamic`, cloning a referenced value if necessary.
2020-08-08 10:24:10 +02:00
#[inline(always)]
2020-10-11 15:58:11 +02:00
pub fn take_or_clone(self) -> Dynamic {
2020-03-30 16:19:37 +02:00
match self {
2020-07-31 12:43:34 +02:00
Self::Ref(r) => r.clone(), // Referenced value is cloned
2020-08-03 06:10:20 +02:00
#[cfg(not(feature = "no_closure"))]
2020-07-31 16:30:23 +02:00
#[cfg(not(feature = "no_object"))]
2020-07-31 12:06:01 +02:00
Self::LockGuard((_, orig)) => orig, // Original value is simply taken
2020-07-31 12:43:34 +02:00
Self::Value(v) => v, // Owned value is simply taken
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_index"))]
2020-06-06 07:06:00 +02:00
Self::StringChar(_, _, ch) => ch, // Character is taken
2020-05-16 05:42:56 +02:00
}
}
2020-10-11 15:58:11 +02:00
/// Take a `&mut Dynamic` reference from the `Target`.
#[inline(always)]
pub fn take_ref(self) -> Option<&'a mut Dynamic> {
match self {
Self::Ref(r) => Some(r),
_ => None,
}
}
2020-05-16 05:42:56 +02:00
/// Get a mutable reference from the `Target`.
2020-08-08 10:24:10 +02:00
#[inline(always)]
2020-05-16 05:42:56 +02:00
pub fn as_mut(&mut self) -> &mut Dynamic {
match self {
2020-06-06 07:06:00 +02:00
Self::Ref(r) => *r,
2020-08-03 06:10:20 +02:00
#[cfg(not(feature = "no_closure"))]
2020-07-31 16:30:23 +02:00
#[cfg(not(feature = "no_object"))]
Self::LockGuard((r, _)) => r.deref_mut(),
2020-06-06 07:06:00 +02:00
Self::Value(ref mut r) => r,
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_index"))]
2020-06-06 07:06:00 +02:00
Self::StringChar(_, _, ref mut r) => r,
2020-03-30 16:19:37 +02:00
}
}
2020-10-04 04:40:44 +02:00
/// Propagate a changed value back to the original source.
/// This has no effect except for string indexing.
2020-10-05 06:05:46 +02:00
#[cfg(not(feature = "no_object"))]
#[inline(always)]
2020-10-04 04:40:44 +02:00
pub fn propagate_changed_value(&mut self) {
match self {
2020-10-05 06:05:46 +02:00
Self::Ref(_) | Self::Value(_) => (),
#[cfg(not(feature = "no_closure"))]
Self::LockGuard(_) => (),
2020-10-04 04:40:44 +02:00
#[cfg(not(feature = "no_index"))]
Self::StringChar(_, _, ch) => {
2020-10-12 11:00:58 +02:00
let char_value = ch.clone();
self.set_value((char_value, Position::none()), Position::none())
2020-10-04 04:40:44 +02:00
.unwrap();
}
}
}
2020-04-26 12:04:07 +02:00
/// Update the value of the `Target`.
#[cfg(any(not(feature = "no_object"), not(feature = "no_index")))]
2020-10-03 17:27:30 +02:00
pub fn set_value(
&mut self,
2020-10-05 07:45:57 +02:00
new_val: (Dynamic, Position),
2020-10-03 17:27:30 +02:00
target_pos: Position,
) -> Result<(), Box<EvalAltResult>> {
2020-03-30 16:19:37 +02:00
match self {
2020-10-05 07:45:57 +02:00
Self::Ref(r) => **r = new_val.0,
2020-08-03 06:10:20 +02:00
#[cfg(not(feature = "no_closure"))]
2020-07-31 16:30:23 +02:00
#[cfg(not(feature = "no_object"))]
2020-10-05 07:45:57 +02:00
Self::LockGuard((r, _)) => **r = new_val.0,
2020-06-06 07:06:00 +02:00
Self::Value(_) => {
2020-10-03 17:27:30 +02:00
return EvalAltResult::ErrorAssignmentToUnknownLHS(target_pos).into();
2020-04-26 12:04:07 +02:00
}
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_index"))]
Self::StringChar(string, index, _) if string.is::<ImmutableString>() => {
let mut s = string.write_lock::<ImmutableString>().unwrap();
2020-05-16 05:42:56 +02:00
// Replace the character at the specified index position
2020-10-05 07:45:57 +02:00
let new_ch = new_val.0.as_char().map_err(|err| {
2020-10-03 17:27:30 +02:00
Box::new(EvalAltResult::ErrorMismatchDataType(
err.to_string(),
"char".to_string(),
2020-10-05 07:45:57 +02:00
new_val.1,
2020-10-03 17:27:30 +02:00
))
})?;
2020-05-16 05:42:56 +02:00
2020-07-23 04:12:51 +02:00
let mut chars = s.chars().collect::<StaticVec<_>>();
2020-05-16 05:42:56 +02:00
// See if changed - if so, update the String
2020-10-12 11:00:58 +02:00
if chars[*index] != new_ch {
2020-05-17 16:19:49 +02:00
chars[*index] = new_ch;
2020-05-25 07:44:28 +02:00
*s = chars.iter().collect::<String>().into();
2020-04-26 12:04:07 +02:00
}
2020-05-16 05:42:56 +02:00
}
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_index"))]
Self::StringChar(_, _, _) => unreachable!(),
2020-03-30 16:19:37 +02:00
}
2020-04-26 12:04:07 +02:00
Ok(())
2020-03-30 16:19:37 +02:00
}
2020-03-05 13:28:03 +01:00
}
impl<'a> From<&'a mut Dynamic> for Target<'a> {
2020-08-08 10:24:10 +02:00
#[inline(always)]
fn from(value: &'a mut Dynamic) -> Self {
2020-08-03 06:10:20 +02:00
#[cfg(not(feature = "no_closure"))]
2020-07-31 16:30:23 +02:00
#[cfg(not(feature = "no_object"))]
if value.is_shared() {
2020-07-31 12:06:01 +02:00
// Cloning is cheap for a shared value
let container = value.clone();
return Self::LockGuard((value.write_lock::<Dynamic>().unwrap(), container));
}
Self::Ref(value)
2020-04-26 12:04:07 +02:00
}
}
2020-04-26 12:04:07 +02:00
impl<T: Into<Dynamic>> From<T> for Target<'_> {
2020-08-08 10:24:10 +02:00
#[inline(always)]
2020-04-26 12:04:07 +02:00
fn from(value: T) -> Self {
2020-05-16 05:42:56 +02:00
Self::Value(value.into())
}
}
2020-10-03 12:49:11 +02:00
/// _[INTERNALS]_ A type that holds all the current states of the Engine.
/// Exported under the `internals` feature only.
///
/// ## WARNING
///
/// This type is volatile and may change.
2020-06-26 04:39:18 +02:00
#[derive(Debug, Clone, Eq, PartialEq, Hash, Default)]
pub struct State {
2020-04-28 17:05:03 +02:00
/// Normally, access to variables are parsed with a relative offset into the scope to avoid a lookup.
2020-05-24 17:42:16 +02:00
/// In some situation, e.g. after running an `eval` statement, subsequent offsets become mis-aligned.
2020-04-28 17:05:03 +02:00
/// When that happens, this flag is turned on to force a scope lookup by name.
pub always_search: bool,
/// Level of the current scope. The global (root) level is zero, a new block (or function call)
/// is one level higher, and so on.
pub scope_level: usize,
/// Number of operations performed.
pub operations: u64,
2020-05-15 15:40:54 +02:00
/// Number of modules loaded.
2020-06-14 08:25:47 +02:00
pub modules: usize,
2020-04-28 17:05:03 +02:00
}
impl State {
2020-04-29 10:11:54 +02:00
/// Create a new `State`.
2020-08-08 10:24:10 +02:00
#[inline(always)]
pub fn new() -> Self {
Default::default()
2020-04-28 17:05:03 +02:00
}
}
2020-10-03 12:49:11 +02:00
/// _[INTERNALS]_ A type containing all the limits imposed by the `Engine`.
2020-07-26 09:53:22 +02:00
/// Exported under the `internals` feature only.
///
/// ## WARNING
///
/// This type is volatile and may change.
#[cfg(not(feature = "unchecked"))]
2020-08-23 10:29:32 +02:00
#[derive(Debug, Clone, Eq, PartialEq, Hash)]
2020-07-26 09:53:22 +02:00
pub struct Limits {
/// Maximum levels of call-stack to prevent infinite recursion.
///
/// Defaults to 16 for debug builds and 128 for non-debug builds.
pub max_call_stack_depth: usize,
/// Maximum depth of statements/expressions at global level (0 = unlimited).
2020-07-26 09:53:22 +02:00
pub max_expr_depth: usize,
/// Maximum depth of statements/expressions in functions (0 = unlimited).
/// Not available under `no_function`.
#[cfg(not(feature = "no_function"))]
2020-07-26 09:53:22 +02:00
pub max_function_expr_depth: usize,
/// Maximum number of operations allowed to run (0 = unlimited).
2020-07-26 09:53:22 +02:00
pub max_operations: u64,
/// Maximum number of modules allowed to load.
/// Not available under `no_module`.
2020-10-18 16:10:08 +02:00
#[cfg(not(feature = "no_module"))]
2020-07-26 09:53:22 +02:00
pub max_modules: usize,
/// Maximum length of a string (0 = unlimited).
2020-07-26 09:53:22 +02:00
pub max_string_size: usize,
/// Maximum length of an array (0 = unlimited).
/// Not available under `no_index`.
#[cfg(not(feature = "no_index"))]
2020-07-26 09:53:22 +02:00
pub max_array_size: usize,
/// Maximum number of properties in a map (0 = unlimited).
/// Not available under `no_object`.
#[cfg(not(feature = "no_object"))]
2020-07-26 09:53:22 +02:00
pub max_map_size: usize,
}
2020-10-11 15:58:11 +02:00
/// Context of a script evaluation process.
#[derive(Debug)]
2020-10-20 04:54:32 +02:00
pub struct EvalContext<'e, 'x, 'px: 'x, 'a, 's, 'm, 'pm: 'm, 't, 'pt: 't> {
pub(crate) engine: &'e Engine,
pub scope: &'x mut Scope<'px>,
2020-10-11 15:58:11 +02:00
pub(crate) mods: &'a mut Imports,
pub(crate) state: &'s mut State,
pub(crate) lib: &'m [&'pm Module],
pub(crate) this_ptr: &'t mut Option<&'pt mut Dynamic>,
pub(crate) level: usize,
2020-10-11 15:58:11 +02:00
}
2020-10-20 04:54:32 +02:00
impl<'e, 'x, 'px, 'a, 's, 'm, 'pm, 't, 'pt> EvalContext<'e, 'x, 'px, 'a, 's, 'm, 'pm, 't, 'pt> {
2020-10-11 15:58:11 +02:00
/// The current `Engine`.
#[inline(always)]
2020-10-11 15:58:11 +02:00
pub fn engine(&self) -> &'e Engine {
self.engine
}
/// _[INTERNALS]_ The current set of modules imported via `import` statements.
/// Available under the `internals` feature only.
#[cfg(feature = "internals")]
2020-10-18 16:10:08 +02:00
#[cfg(not(feature = "no_module"))]
#[inline(always)]
2020-10-11 15:58:11 +02:00
pub fn imports(&self) -> &'a Imports {
self.mods
}
/// Get an iterator over the namespaces containing definition of all script-defined functions.
#[inline(always)]
pub fn iter_namespaces(&self) -> impl Iterator<Item = &'pm Module> + 'm {
self.lib.iter().cloned()
2020-10-11 15:58:11 +02:00
}
/// The current bound `this` pointer, if any.
#[inline(always)]
pub fn this_ptr(&self) -> Option<&Dynamic> {
self.this_ptr.as_ref().map(|v| &**v)
}
2020-10-11 15:58:11 +02:00
/// The current nesting level of function calls.
#[inline(always)]
2020-10-11 15:58:11 +02:00
pub fn call_level(&self) -> usize {
self.level
}
}
2020-03-04 15:00:01 +01:00
/// Rhai main scripting engine.
2017-10-30 16:08:44 +01:00
///
2020-10-27 04:30:38 +01:00
/// # Thread Safety
///
/// `Engine` is re-entrant.
///
/// Currently, `Engine` is neither `Send` nor `Sync`. Use the `sync` feature to make it `Send + Sync`.
///
/// # Example
///
2020-03-19 06:52:10 +01:00
/// ```
/// # fn main() -> Result<(), Box<rhai::EvalAltResult>> {
2017-10-30 16:08:44 +01:00
/// use rhai::Engine;
///
/// let engine = Engine::new();
2017-10-30 16:08:44 +01:00
///
2020-03-09 14:57:07 +01:00
/// let result = engine.eval::<i64>("40 + 2")?;
///
/// println!("Answer: {}", result); // prints 42
/// # Ok(())
/// # }
2017-10-30 16:08:44 +01:00
/// ```
2020-04-16 17:31:48 +02:00
pub struct Engine {
2020-06-15 17:20:50 +02:00
/// A unique ID identifying this scripting `Engine`.
2020-10-27 04:30:38 +01:00
pub id: String,
2020-06-15 17:20:50 +02:00
2020-05-13 13:21:42 +02:00
/// A module containing all functions directly loaded into the Engine.
pub(crate) global_module: Module,
/// A collection of all library packages loaded into the Engine.
pub(crate) packages: PackagesCollection,
2020-05-13 13:21:42 +02:00
2020-05-05 17:57:25 +02:00
/// A module resolution service.
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_module"))]
pub(crate) module_resolver: Option<Box<dyn ModuleResolver>>,
2020-05-13 13:21:42 +02:00
2020-03-27 07:34:01 +01:00
/// A hashmap mapping type names to pretty-print names.
2020-10-25 14:57:18 +01:00
pub(crate) type_names: HashMap<String, String>,
2020-07-05 09:23:51 +02:00
2020-07-05 11:41:45 +02:00
/// A hashset containing symbols to disable.
2020-10-25 14:57:18 +01:00
pub(crate) disabled_symbols: HashSet<String>,
2020-07-05 11:41:45 +02:00
/// A hashset containing custom keywords and precedence to recognize.
2020-10-25 14:57:18 +01:00
pub(crate) custom_keywords: HashMap<String, Option<u8>>,
2020-07-09 13:54:28 +02:00
/// Custom syntax.
2020-10-25 14:57:18 +01:00
pub(crate) custom_syntax: HashMap<ImmutableString, CustomSyntax>,
2020-10-11 15:58:11 +02:00
/// Callback closure for resolving variable access.
pub(crate) resolve_var: Option<OnVarCallback>,
2020-06-02 07:33:16 +02:00
/// Callback closure for implementing the `print` command.
pub(crate) print: Callback<str, ()>,
/// Callback closure for implementing the `debug` command.
pub(crate) debug: Callback<str, ()>,
/// Callback closure for progress reporting.
pub(crate) progress: Option<Callback<u64, bool>>,
2020-03-27 07:34:01 +01:00
/// Optimize the AST after compilation.
pub(crate) optimization_level: OptimizationLevel,
2020-07-26 09:53:22 +02:00
/// Max limits.
#[cfg(not(feature = "unchecked"))]
pub(crate) limits_set: Limits,
2017-12-20 12:16:14 +01:00
}
2020-07-13 13:38:50 +02:00
impl fmt::Debug for Engine {
2020-08-08 10:24:10 +02:00
#[inline(always)]
2020-07-13 13:38:50 +02:00
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
2020-10-27 04:30:38 +01:00
if !self.id.is_empty() {
write!(f, "Engine({})", self.id)
} else {
f.write_str("Engine")
2020-07-13 13:38:50 +02:00
}
}
}
2020-04-16 17:31:48 +02:00
impl Default for Engine {
2020-10-08 16:25:50 +02:00
#[inline(always)]
2020-03-25 04:27:18 +01:00
fn default() -> Self {
2020-10-03 17:27:30 +02:00
Self::new()
2020-03-09 14:57:07 +01:00
}
2020-03-25 04:27:18 +01:00
}
2020-03-30 10:10:50 +02:00
/// Make getter function
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_object"))]
#[inline(always)]
2020-03-30 10:10:50 +02:00
pub fn make_getter(id: &str) -> String {
2020-06-25 05:07:46 +02:00
format!("{}{}", FN_GET, id)
2020-03-30 10:10:50 +02:00
}
/// Make setter function
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_object"))]
#[inline(always)]
2020-03-30 10:10:50 +02:00
pub fn make_setter(id: &str) -> String {
2020-06-25 05:07:46 +02:00
format!("{}{}", FN_SET, id)
2020-03-30 10:10:50 +02:00
}
2020-10-12 16:49:51 +02:00
/// Is this function an anonymous function?
#[cfg(not(feature = "no_function"))]
#[inline(always)]
pub fn is_anonymous_fn(fn_name: &str) -> bool {
fn_name.starts_with(FN_ANONYMOUS)
}
2020-04-19 12:33:02 +02:00
/// Print/debug to stdout
2020-07-26 09:53:22 +02:00
fn default_print(_s: &str) {
2020-04-19 12:33:02 +02:00
#[cfg(not(feature = "no_std"))]
2020-06-17 03:54:17 +02:00
#[cfg(not(target_arch = "wasm32"))]
2020-07-26 09:53:22 +02:00
println!("{}", _s);
2020-04-19 12:33:02 +02:00
}
2020-06-28 09:49:24 +02:00
/// Search for a module within an imports stack.
/// Position in `EvalAltResult` is `None` and must be set afterwards.
pub fn search_imports<'s>(
mods: &'s Imports,
state: &mut State,
modules: &Box<ModuleRef>,
) -> Result<&'s Module, Box<EvalAltResult>> {
2020-07-29 10:10:06 +02:00
let (root, root_pos) = &modules[0];
// Qualified - check if the root module is directly indexed
let index = if state.always_search {
2020-10-12 11:00:58 +02:00
0
} else {
2020-10-12 11:00:58 +02:00
modules.index().map_or(0, NonZeroUsize::get)
};
2020-10-12 11:00:58 +02:00
Ok(if index > 0 {
let offset = mods.len() - index;
&mods.get(offset).unwrap().1
} else {
mods.iter()
.rev()
.find(|(n, _)| n == root)
.map(|(_, m)| m)
2020-08-06 04:17:32 +02:00
.ok_or_else(|| EvalAltResult::ErrorModuleNotFound(root.to_string(), *root_pos))?
})
}
/// Search for a module within an imports stack.
/// Position in `EvalAltResult` is `None` and must be set afterwards.
pub fn search_imports_mut<'s>(
2020-06-28 09:49:24 +02:00
mods: &'s mut Imports,
state: &mut State,
modules: &Box<ModuleRef>,
) -> Result<&'s mut Module, Box<EvalAltResult>> {
2020-07-29 10:10:06 +02:00
let (root, root_pos) = &modules[0];
2020-06-28 09:49:24 +02:00
// Qualified - check if the root module is directly indexed
let index = if state.always_search {
2020-10-12 11:00:58 +02:00
0
2020-06-28 09:49:24 +02:00
} else {
2020-10-12 11:00:58 +02:00
modules.index().map_or(0, NonZeroUsize::get)
2020-06-28 09:49:24 +02:00
};
2020-10-12 11:00:58 +02:00
Ok(if index > 0 {
let offset = mods.len() - index;
2020-06-28 09:49:24 +02:00
&mut mods.get_mut(offset).unwrap().1
} else {
mods.iter_mut()
.rev()
.find(|(n, _)| n == root)
.map(|(_, m)| m)
2020-08-06 04:17:32 +02:00
.ok_or_else(|| EvalAltResult::ErrorModuleNotFound(root.to_string(), *root_pos))?
2020-06-28 09:49:24 +02:00
})
}
2020-04-16 17:31:48 +02:00
impl Engine {
2020-03-25 04:27:18 +01:00
/// Create a new `Engine`
2020-10-08 16:25:50 +02:00
#[inline(always)]
2020-03-25 04:27:18 +01:00
pub fn new() -> Self {
2020-10-03 17:27:30 +02:00
// Create the new scripting Engine
let mut engine = Self {
2020-10-27 04:30:38 +01:00
id: Default::default(),
2020-10-03 17:27:30 +02:00
packages: Default::default(),
global_module: Default::default(),
#[cfg(not(feature = "no_module"))]
#[cfg(not(feature = "no_std"))]
#[cfg(not(target_arch = "wasm32"))]
module_resolver: Some(Box::new(resolvers::FileModuleResolver::new())),
#[cfg(not(feature = "no_module"))]
#[cfg(any(feature = "no_std", target_arch = "wasm32",))]
module_resolver: None,
2020-10-25 14:57:18 +01:00
type_names: Default::default(),
disabled_symbols: Default::default(),
custom_keywords: Default::default(),
custom_syntax: Default::default(),
2020-10-03 17:27:30 +02:00
2020-10-11 15:58:11 +02:00
// variable resolver
resolve_var: None,
2020-10-03 17:27:30 +02:00
// default print/debug implementations
print: Box::new(default_print),
debug: Box::new(default_print),
// progress callback
progress: None,
// optimization level
optimization_level: if cfg!(feature = "no_optimize") {
OptimizationLevel::None
} else {
OptimizationLevel::Simple
},
#[cfg(not(feature = "unchecked"))]
limits_set: Limits {
2020-10-03 17:27:30 +02:00
max_call_stack_depth: MAX_CALL_STACK_DEPTH,
max_expr_depth: MAX_EXPR_DEPTH,
#[cfg(not(feature = "no_function"))]
2020-10-03 17:27:30 +02:00
max_function_expr_depth: MAX_FUNCTION_EXPR_DEPTH,
max_operations: 0,
#[cfg(not(feature = "no_module"))]
2020-10-03 17:27:30 +02:00
max_modules: usize::MAX,
max_string_size: 0,
#[cfg(not(feature = "no_index"))]
2020-10-03 17:27:30 +02:00
max_array_size: 0,
#[cfg(not(feature = "no_object"))]
2020-10-03 17:27:30 +02:00
max_map_size: 0,
},
};
engine.load_package(StandardPackage::new().get());
engine
2020-03-25 04:27:18 +01:00
}
2020-03-09 14:57:07 +01:00
2020-05-24 17:42:16 +02:00
/// Create a new `Engine` with minimal built-in functions.
/// Use the `load_package` method to load additional packages of functions.
2020-10-08 16:25:50 +02:00
#[inline(always)]
pub fn new_raw() -> Self {
Self {
2020-10-27 04:30:38 +01:00
id: Default::default(),
2020-06-15 17:20:50 +02:00
2020-05-05 09:00:10 +02:00
packages: Default::default(),
2020-05-13 13:21:42 +02:00
global_module: Default::default(),
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_module"))]
module_resolver: None,
2020-10-25 14:57:18 +01:00
type_names: Default::default(),
disabled_symbols: Default::default(),
custom_keywords: Default::default(),
custom_syntax: Default::default(),
2020-07-05 09:23:51 +02:00
2020-10-11 15:58:11 +02:00
resolve_var: None,
2020-04-27 15:28:31 +02:00
print: Box::new(|_| {}),
debug: Box::new(|_| {}),
progress: None,
2020-07-31 16:30:23 +02:00
optimization_level: if cfg!(feature = "no_optimize") {
OptimizationLevel::None
} else {
OptimizationLevel::Simple
},
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "unchecked"))]
limits_set: Limits {
2020-07-26 09:53:22 +02:00
max_call_stack_depth: MAX_CALL_STACK_DEPTH,
max_expr_depth: MAX_EXPR_DEPTH,
#[cfg(not(feature = "no_function"))]
2020-07-26 09:53:22 +02:00
max_function_expr_depth: MAX_FUNCTION_EXPR_DEPTH,
max_operations: 0,
#[cfg(not(feature = "no_module"))]
2020-07-26 09:53:22 +02:00
max_modules: usize::MAX,
max_string_size: 0,
#[cfg(not(feature = "no_index"))]
2020-07-26 09:53:22 +02:00
max_array_size: 0,
#[cfg(not(feature = "no_object"))]
2020-07-26 09:53:22 +02:00
max_map_size: 0,
},
}
}
2020-10-11 15:58:11 +02:00
/// Search for a variable within the scope or within imports,
/// depending on whether the variable name is qualified.
pub(crate) fn search_namespace<'s, 'a>(
&self,
scope: &'s mut Scope,
mods: &'s mut Imports,
state: &mut State,
2020-10-20 04:54:32 +02:00
lib: &[&Module],
2020-10-11 15:58:11 +02:00
this_ptr: &'s mut Option<&mut Dynamic>,
expr: &'a Expr,
) -> Result<(Target<'s>, &'a str, ScopeEntryType, Position), Box<EvalAltResult>> {
match expr {
Expr::Variable(v) => match v.as_ref() {
// Qualified variable
((name, pos), Some(modules), hash_var, _) => {
let module = search_imports_mut(mods, state, modules)?;
2020-10-12 11:00:58 +02:00
let target = module.get_qualified_var_mut(*hash_var).map_err(|mut err| {
match *err {
EvalAltResult::ErrorVariableNotFound(ref mut err_name, _) => {
*err_name = format!("{}{}", modules, name);
}
_ => (),
}
err.fill_position(*pos)
})?;
2020-10-11 15:58:11 +02:00
// Module variables are constant
Ok((target.into(), name, ScopeEntryType::Constant, *pos))
}
// Normal variable access
_ => self.search_scope_only(scope, mods, state, lib, this_ptr, expr),
},
_ => unreachable!(),
}
}
/// Search for a variable within the scope
pub(crate) fn search_scope_only<'s, 'a>(
&self,
scope: &'s mut Scope,
mods: &mut Imports,
state: &mut State,
2020-10-20 04:54:32 +02:00
lib: &[&Module],
2020-10-11 15:58:11 +02:00
this_ptr: &'s mut Option<&mut Dynamic>,
expr: &'a Expr,
) -> Result<(Target<'s>, &'a str, ScopeEntryType, Position), Box<EvalAltResult>> {
let ((name, pos), _, _, index) = match expr {
Expr::Variable(v) => v.as_ref(),
_ => unreachable!(),
};
// Check if the variable is `this`
if name == KEYWORD_THIS {
if let Some(val) = this_ptr {
return Ok(((*val).into(), KEYWORD_THIS, ScopeEntryType::Normal, *pos));
} else {
return EvalAltResult::ErrorUnboundThis(*pos).into();
}
}
// Check if it is directly indexed
2020-10-12 11:00:58 +02:00
let index = if state.always_search {
0
} else {
index.map_or(0, NonZeroUsize::get)
};
2020-10-11 15:58:11 +02:00
// Check the variable resolver, if any
if let Some(ref resolve_var) = self.resolve_var {
let context = EvalContext {
engine: self,
scope,
2020-10-11 15:58:11 +02:00
mods,
state,
lib,
this_ptr,
level: 0,
};
2020-10-12 11:00:58 +02:00
if let Some(result) =
resolve_var(name, index, &context).map_err(|err| err.fill_position(*pos))?
2020-10-11 15:58:11 +02:00
{
return Ok((result.into(), name, ScopeEntryType::Constant, *pos));
}
}
2020-10-12 11:00:58 +02:00
let index = if index > 0 {
scope.len() - index
2020-10-11 15:58:11 +02:00
} else {
// Find the variable in the scope
scope
.get_index(name)
.ok_or_else(|| EvalAltResult::ErrorVariableNotFound(name.into(), *pos))?
.0
};
let (val, typ) = scope.get_mut(index);
// Check for data race - probably not necessary because the only place it should conflict is in a method call
// when the object variable is also used as a parameter.
// if cfg!(not(feature = "no_closure")) && val.is_locked() {
// return EvalAltResult::ErrorDataRace(name.into(), *pos).into();
// }
Ok((val.into(), name, typ, *pos))
}
2020-04-26 12:04:07 +02:00
/// Chain-evaluate a dot/index chain.
/// Position in `EvalAltResult` is `None` and must be set afterwards.
2020-07-26 09:53:22 +02:00
#[cfg(any(not(feature = "no_index"), not(feature = "no_object")))]
2020-04-26 12:04:07 +02:00
fn eval_dot_index_chain_helper(
&self,
state: &mut State,
2020-10-20 04:54:32 +02:00
lib: &[&Module],
2020-06-26 04:39:18 +02:00
this_ptr: &mut Option<&mut Dynamic>,
2020-05-16 05:42:56 +02:00
target: &mut Target,
2020-04-26 12:04:07 +02:00
rhs: &Expr,
2020-10-15 17:30:30 +02:00
mut idx_values: StaticVec<IndexChainValue>,
chain_type: ChainType,
2020-03-27 07:34:01 +01:00
level: usize,
2020-10-05 07:45:57 +02:00
new_val: Option<(Dynamic, Position)>,
2020-04-26 12:04:07 +02:00
) -> Result<(Dynamic, bool), Box<EvalAltResult>> {
2020-06-25 05:07:46 +02:00
if chain_type == ChainType::None {
panic!();
}
2020-05-16 05:42:56 +02:00
let is_ref = target.is_ref();
2020-03-01 17:11:00 +01:00
2020-06-25 05:07:46 +02:00
let next_chain = match rhs {
Expr::Index(_) => ChainType::Index,
Expr::Dot(_) => ChainType::Dot,
_ => ChainType::None,
};
2020-04-26 12:04:07 +02:00
// Pop the last index value
2020-07-29 10:10:06 +02:00
let idx_val = idx_values.pop().unwrap();
2020-03-01 17:11:00 +01:00
match chain_type {
#[cfg(not(feature = "no_index"))]
ChainType::Index => {
let pos = rhs.position();
match rhs {
// xxx[idx].expr... | xxx[idx][expr]...
Expr::Dot(x) | Expr::Index(x) => {
let (idx, expr, pos) = x.as_ref();
let idx_pos = idx.position();
2020-10-15 17:30:30 +02:00
let idx_val = idx_val.as_value();
2020-08-01 06:21:15 +02:00
let obj_ptr = &mut self.get_indexed_mut(
state, lib, target, idx_val, idx_pos, false, true, level,
)?;
self.eval_dot_index_chain_helper(
2020-06-26 04:39:18 +02:00
state, lib, this_ptr, obj_ptr, expr, idx_values, next_chain, level,
2020-10-05 07:45:57 +02:00
new_val,
)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*pos))
}
// xxx[rhs] = new_val
2020-08-08 10:24:10 +02:00
_ if new_val.is_some() => {
2020-10-15 17:30:30 +02:00
let idx_val = idx_val.as_value();
let mut idx_val2 = idx_val.clone();
2020-07-31 17:37:30 +02:00
// `call_setter` is introduced to bypass double mutable borrowing of target
2020-08-01 06:21:15 +02:00
let _call_setter = match self
.get_indexed_mut(state, lib, target, idx_val, pos, true, false, level)
2020-07-31 17:37:30 +02:00
{
// Indexed value is a reference - update directly
2020-06-26 04:39:18 +02:00
Ok(ref mut obj_ptr) => {
2020-10-05 07:45:57 +02:00
obj_ptr.set_value(new_val.unwrap(), rhs.position())?;
2020-07-31 17:37:30 +02:00
None
}
Err(err) => match *err {
// No index getter - try to call an index setter
2020-08-01 06:21:15 +02:00
#[cfg(not(feature = "no_index"))]
EvalAltResult::ErrorIndexingType(_, _) => Some(new_val.unwrap()),
2020-07-31 17:37:30 +02:00
// Any other error - return
err => return Err(Box::new(err)),
},
};
2020-08-01 06:21:15 +02:00
#[cfg(not(feature = "no_index"))]
if let Some(mut new_val) = _call_setter {
let val = target.as_mut();
let val_type_name = val.type_name();
2020-10-05 07:45:57 +02:00
let args = &mut [val, &mut idx_val2, &mut new_val.0];
2020-08-01 06:21:15 +02:00
self.exec_fn_call(
state, lib, FN_IDX_SET, 0, args, is_ref, true, false, None, &None,
2020-07-31 17:37:30 +02:00
level,
2020-08-01 06:21:15 +02:00
)
.map_err(|err| match *err {
2020-10-19 08:26:15 +02:00
EvalAltResult::ErrorFunctionNotFound(fn_sig, _)
if fn_sig.ends_with("]=") =>
{
2020-08-01 06:21:15 +02:00
EvalAltResult::ErrorIndexingType(
self.map_type_name(val_type_name).into(),
Position::none(),
)
}
err => err,
})?;
}
Ok(Default::default())
2020-06-06 07:06:00 +02:00
}
// xxx[rhs]
2020-10-15 17:30:30 +02:00
_ => {
let idx_val = idx_val.as_value();
self.get_indexed_mut(state, lib, target, idx_val, pos, false, true, level)
.map(|v| (v.take_or_clone(), false))
}
2020-04-26 12:04:07 +02:00
}
}
#[cfg(not(feature = "no_object"))]
ChainType::Dot => {
match rhs {
// xxx.fn_name(arg_expr_list)
Expr::FnCall(x) if x.1.is_none() => {
2020-07-30 12:18:28 +02:00
let ((name, native, _, pos), _, hash, _, def_val) = x.as_ref();
let def_val = def_val.map(Into::<Dynamic>::into);
2020-10-15 17:30:30 +02:00
let args = idx_val.as_fn_call_args();
self.make_method_call(
2020-10-15 17:30:30 +02:00
state, lib, name, *hash, target, args, &def_val, *native, false, level,
)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*pos))
}
// xxx.module::fn_name(...) - syntax error
Expr::FnCall(_) => unreachable!(),
// {xxx:map}.id = ???
2020-08-08 10:24:10 +02:00
Expr::Property(x) if target.is::<Map>() && new_val.is_some() => {
let ((prop, _, _), pos) = x.as_ref();
let index = prop.clone().into();
2020-08-01 06:21:15 +02:00
let mut val = self
.get_indexed_mut(state, lib, target, index, *pos, true, false, level)?;
2020-10-05 07:45:57 +02:00
val.set_value(new_val.unwrap(), rhs.position())?;
Ok((Default::default(), true))
}
// {xxx:map}.id
Expr::Property(x) if target.is::<Map>() => {
let ((prop, _, _), pos) = x.as_ref();
let index = prop.clone().into();
2020-08-01 06:21:15 +02:00
let val = self.get_indexed_mut(
state, lib, target, index, *pos, false, false, level,
)?;
2020-05-11 17:48:50 +02:00
2020-10-11 15:58:11 +02:00
Ok((val.take_or_clone(), false))
}
// xxx.id = ???
2020-08-08 10:24:10 +02:00
Expr::Property(x) if new_val.is_some() => {
let ((_, _, setter), pos) = x.as_ref();
2020-08-08 10:24:10 +02:00
let mut new_val = new_val;
2020-10-05 07:45:57 +02:00
let mut args = [target.as_mut(), &mut new_val.as_mut().unwrap().0];
2020-06-26 04:39:18 +02:00
self.exec_fn_call(
state, lib, setter, 0, &mut args, is_ref, true, false, None, &None,
level,
2020-06-26 04:39:18 +02:00
)
.map(|(v, _)| (v, true))
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*pos))
}
// xxx.id
Expr::Property(x) => {
let ((_, getter, _), pos) = x.as_ref();
let mut args = [target.as_mut()];
2020-06-26 04:39:18 +02:00
self.exec_fn_call(
state, lib, getter, 0, &mut args, is_ref, true, false, None, &None,
level,
2020-06-26 04:39:18 +02:00
)
.map(|(v, _)| (v, false))
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*pos))
}
2020-07-09 16:21:07 +02:00
// {xxx:map}.sub_lhs[expr] | {xxx:map}.sub_lhs.expr
Expr::Index(x) | Expr::Dot(x) if target.is::<Map>() => {
2020-07-09 16:21:07 +02:00
let (sub_lhs, expr, pos) = x.as_ref();
let mut val = match sub_lhs {
Expr::Property(p) => {
let ((prop, _, _), pos) = p.as_ref();
2020-07-09 16:21:07 +02:00
let index = prop.clone().into();
2020-08-01 06:21:15 +02:00
self.get_indexed_mut(
state, lib, target, index, *pos, false, true, level,
)?
2020-07-09 16:21:07 +02:00
}
// {xxx:map}.fn_name(arg_expr_list)[expr] | {xxx:map}.fn_name(arg_expr_list).expr
Expr::FnCall(x) if x.1.is_none() => {
2020-07-30 12:18:28 +02:00
let ((name, native, _, pos), _, hash, _, def_val) = x.as_ref();
let def_val = def_val.map(Into::<Dynamic>::into);
2020-10-15 17:30:30 +02:00
let args = idx_val.as_fn_call_args();
let (val, _) = self
.make_method_call(
2020-10-15 17:30:30 +02:00
state, lib, name, *hash, target, args, &def_val, *native,
false, level,
)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*pos))?;
2020-07-09 16:21:07 +02:00
val.into()
}
// {xxx:map}.module::fn_name(...) - syntax error
Expr::FnCall(_) => unreachable!(),
// Others - syntax error
_ => unreachable!(),
};
self.eval_dot_index_chain_helper(
2020-06-26 04:39:18 +02:00
state, lib, this_ptr, &mut val, expr, idx_values, next_chain, level,
2020-10-05 07:45:57 +02:00
new_val,
2020-06-01 09:25:22 +02:00
)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*pos))
}
2020-07-09 16:21:07 +02:00
// xxx.sub_lhs[expr] | xxx.sub_lhs.expr
Expr::Index(x) | Expr::Dot(x) => {
let (sub_lhs, expr, _) = x.as_ref();
2020-07-09 16:21:07 +02:00
match sub_lhs {
// xxx.prop[expr] | xxx.prop.expr
Expr::Property(p) => {
let ((_, getter, setter), pos) = p.as_ref();
2020-07-09 16:21:07 +02:00
let arg_values = &mut [target.as_mut(), &mut Default::default()];
let args = &mut arg_values[..1];
let (mut val, updated) = self
.exec_fn_call(
2020-07-30 12:18:28 +02:00
state, lib, getter, 0, args, is_ref, true, false, None,
&None, level,
2020-07-09 16:21:07 +02:00
)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*pos))?;
2020-07-09 16:21:07 +02:00
let val = &mut val;
let (result, may_be_changed) = self
.eval_dot_index_chain_helper(
state,
lib,
this_ptr,
&mut val.into(),
expr,
idx_values,
next_chain,
level,
2020-08-08 10:24:10 +02:00
new_val,
2020-07-09 16:21:07 +02:00
)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*pos))?;
2020-07-09 16:21:07 +02:00
// Feed the value back via a setter just in case it has been updated
if updated || may_be_changed {
// Re-use args because the first &mut parameter will not be consumed
arg_values[1] = val;
self.exec_fn_call(
2020-07-30 12:18:28 +02:00
state, lib, setter, 0, arg_values, is_ref, true, false,
None, &None, level,
2020-07-09 16:21:07 +02:00
)
.or_else(
|err| match *err {
// If there is no setter, no need to feed it back because the property is read-only
EvalAltResult::ErrorDotExpr(_, _) => {
Ok(Default::default())
}
2020-10-11 15:58:11 +02:00
_ => Err(err.fill_position(*pos)),
2020-07-09 16:21:07 +02:00
},
)?;
}
Ok((result, may_be_changed))
}
// xxx.fn_name(arg_expr_list)[expr] | xxx.fn_name(arg_expr_list).expr
Expr::FnCall(x) if x.1.is_none() => {
2020-07-30 12:18:28 +02:00
let ((name, native, _, pos), _, hash, _, def_val) = x.as_ref();
let def_val = def_val.map(Into::<Dynamic>::into);
2020-10-15 17:30:30 +02:00
let args = idx_val.as_fn_call_args();
let (mut val, _) = self
.make_method_call(
2020-10-15 17:30:30 +02:00
state, lib, name, *hash, target, args, &def_val, *native,
false, level,
)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*pos))?;
2020-07-09 16:21:07 +02:00
let val = &mut val;
let target = &mut val.into();
self.eval_dot_index_chain_helper(
state, lib, this_ptr, target, expr, idx_values, next_chain,
2020-10-05 07:45:57 +02:00
level, new_val,
)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*pos))
}
2020-07-09 16:21:07 +02:00
// xxx.module::fn_name(...) - syntax error
Expr::FnCall(_) => unreachable!(),
// Others - syntax error
_ => unreachable!(),
2020-04-26 12:04:07 +02:00
}
}
// Syntax error
2020-08-06 04:17:32 +02:00
_ => EvalAltResult::ErrorDotExpr("".into(), rhs.position()).into(),
}
2020-04-26 12:04:07 +02:00
}
_ => unreachable!(),
}
}
2020-04-26 15:48:49 +02:00
/// Evaluate a dot/index chain.
2020-07-26 09:53:22 +02:00
#[cfg(any(not(feature = "no_index"), not(feature = "no_object")))]
2020-04-26 12:04:07 +02:00
fn eval_dot_index_chain(
&self,
scope: &mut Scope,
mods: &mut Imports,
2020-04-28 17:05:03 +02:00
state: &mut State,
2020-10-20 04:54:32 +02:00
lib: &[&Module],
2020-06-26 04:39:18 +02:00
this_ptr: &mut Option<&mut Dynamic>,
2020-05-31 09:51:26 +02:00
expr: &Expr,
2020-03-27 07:34:01 +01:00
level: usize,
2020-10-05 07:45:57 +02:00
new_val: Option<(Dynamic, Position)>,
) -> Result<Dynamic, Box<EvalAltResult>> {
let ((dot_lhs, dot_rhs, op_pos), chain_type) = match expr {
Expr::Index(x) => (x.as_ref(), ChainType::Index),
Expr::Dot(x) => (x.as_ref(), ChainType::Dot),
2020-05-31 09:51:26 +02:00
_ => unreachable!(),
};
2020-10-15 17:30:30 +02:00
let mut idx_values = StaticVec::new();
2020-03-25 04:27:18 +01:00
self.eval_indexed_chain(
2020-10-15 17:30:30 +02:00
scope,
mods,
state,
lib,
this_ptr,
dot_rhs,
chain_type,
&mut idx_values,
0,
level,
)?;
2020-04-11 10:06:57 +02:00
2020-04-26 12:04:07 +02:00
match dot_lhs {
// id.??? or id[???]
2020-06-26 04:39:18 +02:00
Expr::Variable(x) => {
let (var_name, var_pos) = &x.0;
2020-06-01 09:25:22 +02:00
self.inc_operations(state)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*var_pos))?;
2020-06-26 04:39:18 +02:00
let (target, _, typ, pos) =
2020-10-11 15:58:11 +02:00
self.search_namespace(scope, mods, state, lib, this_ptr, dot_lhs)?;
2020-04-26 12:04:07 +02:00
// Constants cannot be modified
match typ {
ScopeEntryType::Constant if new_val.is_some() => {
2020-08-06 04:17:32 +02:00
return EvalAltResult::ErrorAssignmentToConstant(var_name.to_string(), pos)
.into();
}
2020-05-04 17:07:42 +02:00
ScopeEntryType::Constant | ScopeEntryType::Normal => (),
}
2020-06-26 04:39:18 +02:00
let obj_ptr = &mut target.into();
2020-04-26 12:04:07 +02:00
self.eval_dot_index_chain_helper(
2020-10-05 07:45:57 +02:00
state, lib, &mut None, obj_ptr, dot_rhs, idx_values, chain_type, level, new_val,
2020-04-26 12:04:07 +02:00
)
.map(|(v, _)| v)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*op_pos))
}
2020-04-26 12:04:07 +02:00
// {expr}.??? = ??? or {expr}[???] = ???
expr if new_val.is_some() => {
2020-08-06 04:17:32 +02:00
return EvalAltResult::ErrorAssignmentToUnknownLHS(expr.position()).into();
2020-04-26 12:04:07 +02:00
}
// {expr}.??? or {expr}[???]
expr => {
let val = self.eval_expr(scope, mods, state, lib, this_ptr, expr, level)?;
2020-06-26 04:39:18 +02:00
let obj_ptr = &mut val.into();
2020-04-26 12:04:07 +02:00
self.eval_dot_index_chain_helper(
2020-06-26 04:39:18 +02:00
state, lib, this_ptr, obj_ptr, dot_rhs, idx_values, chain_type, level, new_val,
2020-04-26 12:04:07 +02:00
)
.map(|(v, _)| v)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*op_pos))
}
}
}
2020-10-15 17:30:30 +02:00
/// Evaluate a chain of indexes and store the results in a StaticVec.
/// StaticVec is used to avoid an allocation in the overwhelming cases of just a few levels of indexing.
2020-07-26 09:53:22 +02:00
#[cfg(any(not(feature = "no_index"), not(feature = "no_object")))]
2020-04-26 12:04:07 +02:00
fn eval_indexed_chain(
&self,
scope: &mut Scope,
mods: &mut Imports,
2020-04-28 17:05:03 +02:00
state: &mut State,
2020-10-20 04:54:32 +02:00
lib: &[&Module],
2020-06-26 04:39:18 +02:00
this_ptr: &mut Option<&mut Dynamic>,
2020-04-26 12:04:07 +02:00
expr: &Expr,
2020-07-09 16:21:07 +02:00
chain_type: ChainType,
2020-10-15 17:30:30 +02:00
idx_values: &mut StaticVec<IndexChainValue>,
2020-04-26 12:04:07 +02:00
size: usize,
2020-03-27 07:34:01 +01:00
level: usize,
) -> Result<(), Box<EvalAltResult>> {
2020-06-01 09:25:22 +02:00
self.inc_operations(state)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(expr.position()))?;
2020-05-17 16:19:49 +02:00
2020-04-26 15:48:49 +02:00
match expr {
Expr::FnCall(x) if x.1.is_none() => {
let arg_values =
x.3.iter()
.map(|arg_expr| {
self.eval_expr(scope, mods, state, lib, this_ptr, arg_expr, level)
})
2020-10-15 17:30:30 +02:00
.collect::<Result<StaticVec<_>, _>>()?;
2020-04-26 12:04:07 +02:00
2020-10-15 17:30:30 +02:00
idx_values.push(arg_values.into());
2020-04-26 12:04:07 +02:00
}
Expr::FnCall(_) => unreachable!(),
2020-10-15 17:30:30 +02:00
Expr::Property(_) => idx_values.push(IndexChainValue::None),
Expr::Index(x) | Expr::Dot(x) => {
2020-05-30 04:27:48 +02:00
let (lhs, rhs, _) = x.as_ref();
2020-04-26 12:04:07 +02:00
// Evaluate in left-to-right order
2020-05-30 04:27:48 +02:00
let lhs_val = match lhs {
2020-10-15 17:30:30 +02:00
Expr::Property(_) => IndexChainValue::None,
2020-07-09 16:21:07 +02:00
Expr::FnCall(x) if chain_type == ChainType::Dot && x.1.is_none() => {
2020-10-15 17:30:30 +02:00
x.3.iter()
2020-07-09 16:21:07 +02:00
.map(|arg_expr| {
self.eval_expr(scope, mods, state, lib, this_ptr, arg_expr, level)
})
2020-10-15 17:30:30 +02:00
.collect::<Result<StaticVec<Dynamic>, _>>()?
.into()
2020-07-09 16:21:07 +02:00
}
Expr::FnCall(_) => unreachable!(),
2020-10-15 17:30:30 +02:00
_ => self
.eval_expr(scope, mods, state, lib, this_ptr, lhs, level)?
.into(),
2020-04-26 12:04:07 +02:00
};
// Push in reverse order
2020-07-09 16:21:07 +02:00
let chain_type = match expr {
Expr::Index(_) => ChainType::Index,
Expr::Dot(_) => ChainType::Dot,
_ => unreachable!(),
};
self.eval_indexed_chain(
2020-07-09 16:21:07 +02:00
scope, mods, state, lib, this_ptr, rhs, chain_type, idx_values, size, level,
)?;
2020-04-26 12:04:07 +02:00
idx_values.push(lhs_val);
2020-04-26 12:04:07 +02:00
}
2020-10-15 17:30:30 +02:00
_ => idx_values.push(
self.eval_expr(scope, mods, state, lib, this_ptr, expr, level)?
.into(),
),
2020-04-26 15:48:49 +02:00
}
Ok(())
2020-04-26 12:04:07 +02:00
}
/// Get the value at the indexed position of a base type
2020-06-01 09:25:22 +02:00
/// Position in `EvalAltResult` may be None and should be set afterwards.
2020-07-26 09:53:22 +02:00
#[cfg(any(not(feature = "no_index"), not(feature = "no_object")))]
2020-04-26 12:04:07 +02:00
fn get_indexed_mut<'a>(
&self,
state: &mut State,
2020-10-20 04:54:32 +02:00
_lib: &[&Module],
2020-06-06 07:06:00 +02:00
target: &'a mut Target,
2020-08-08 10:24:10 +02:00
idx: Dynamic,
2020-04-26 12:04:07 +02:00
idx_pos: Position,
2020-07-26 09:53:22 +02:00
_create: bool,
2020-08-01 06:21:15 +02:00
_indexers: bool,
2020-07-26 09:53:22 +02:00
_level: usize,
2020-04-26 12:04:07 +02:00
) -> Result<Target<'a>, Box<EvalAltResult>> {
2020-06-01 09:25:22 +02:00
self.inc_operations(state)?;
#[cfg(not(feature = "no_index"))]
2020-06-06 07:06:00 +02:00
let is_ref = target.is_ref();
2020-07-26 09:53:22 +02:00
2020-06-06 07:06:00 +02:00
let val = target.as_mut();
2020-04-26 12:04:07 +02:00
match val {
#[cfg(not(feature = "no_index"))]
2020-04-26 12:04:07 +02:00
Dynamic(Union::Array(arr)) => {
// val_array[idx]
2020-08-08 10:24:10 +02:00
let index = idx
.as_int()
2020-10-05 07:45:57 +02:00
.map_err(|err| self.make_type_mismatch_err::<INT>(err, idx_pos))?;
2020-04-19 12:33:02 +02:00
let arr_len = arr.len();
if index >= 0 {
2020-04-26 12:04:07 +02:00
arr.get_mut(index as usize)
.map(Target::from)
.ok_or_else(|| {
2020-08-06 04:17:32 +02:00
EvalAltResult::ErrorArrayBounds(arr_len, index, idx_pos).into()
})
} else {
2020-08-06 04:17:32 +02:00
EvalAltResult::ErrorArrayBounds(arr_len, index, idx_pos).into()
}
}
2020-03-29 17:53:35 +02:00
#[cfg(not(feature = "no_object"))]
2020-04-26 12:04:07 +02:00
Dynamic(Union::Map(map)) => {
// val_map[idx]
2020-07-26 09:53:22 +02:00
Ok(if _create {
2020-10-05 07:45:57 +02:00
let index = idx.take_immutable_string().map_err(|err| {
self.make_type_mismatch_err::<ImmutableString>(err, idx_pos)
})?;
2020-05-25 07:44:28 +02:00
2020-09-20 20:07:43 +02:00
map.entry(index).or_insert_with(Default::default).into()
2020-04-26 12:04:07 +02:00
} else {
2020-10-05 07:45:57 +02:00
let index = idx.read_lock::<ImmutableString>().ok_or_else(|| {
self.make_type_mismatch_err::<ImmutableString>("", idx_pos)
})?;
2020-05-25 07:44:28 +02:00
map.get_mut(&*index)
.map(Target::from)
.unwrap_or_else(|| Target::from(()))
2020-04-26 12:04:07 +02:00
})
}
2020-04-10 06:16:39 +02:00
#[cfg(not(feature = "no_index"))]
2020-04-26 12:04:07 +02:00
Dynamic(Union::Str(s)) => {
// val_string[idx]
2020-05-11 17:48:50 +02:00
let chars_len = s.chars().count();
2020-08-08 10:24:10 +02:00
let index = idx
.as_int()
2020-10-05 07:45:57 +02:00
.map_err(|err| self.make_type_mismatch_err::<INT>(err, idx_pos))?;
if index >= 0 {
2020-05-11 17:48:50 +02:00
let offset = index as usize;
let ch = s.chars().nth(offset).ok_or_else(|| {
2020-08-06 04:17:32 +02:00
EvalAltResult::ErrorStringBounds(chars_len, index, idx_pos)
})?;
2020-05-16 05:42:56 +02:00
Ok(Target::StringChar(val, offset, ch.into()))
} else {
2020-08-06 04:17:32 +02:00
EvalAltResult::ErrorStringBounds(chars_len, index, idx_pos).into()
}
}
2020-03-29 17:53:35 +02:00
#[cfg(not(feature = "no_index"))]
2020-08-01 06:21:15 +02:00
_ if _indexers => {
let type_name = val.type_name();
2020-08-08 10:24:10 +02:00
let mut idx = idx;
let args = &mut [val, &mut idx];
2020-06-26 04:39:18 +02:00
self.exec_fn_call(
state, _lib, FN_IDX_GET, 0, args, is_ref, true, false, None, &None, _level,
2020-06-26 04:39:18 +02:00
)
.map(|(v, _)| v.into())
2020-07-25 03:55:33 +02:00
.map_err(|err| match *err {
2020-10-19 11:26:47 +02:00
EvalAltResult::ErrorFunctionNotFound(fn_sig, _) if fn_sig.ends_with(']') => {
2020-10-19 08:26:15 +02:00
Box::new(EvalAltResult::ErrorIndexingType(
type_name.into(),
Position::none(),
))
}
2020-07-25 03:55:33 +02:00
_ => err,
2020-06-26 04:39:18 +02:00
})
2020-05-05 14:38:48 +02:00
}
2020-08-06 04:17:32 +02:00
_ => EvalAltResult::ErrorIndexingType(
self.map_type_name(val.type_name()).into(),
Position::none(),
2020-08-06 04:17:32 +02:00
)
.into(),
2020-03-04 15:00:01 +01:00
}
}
2020-04-06 11:47:34 +02:00
// Evaluate an 'in' expression
fn eval_in_expr(
&self,
2020-04-06 11:47:34 +02:00
scope: &mut Scope,
mods: &mut Imports,
2020-04-28 17:05:03 +02:00
state: &mut State,
2020-10-20 04:54:32 +02:00
lib: &[&Module],
2020-06-26 04:39:18 +02:00
this_ptr: &mut Option<&mut Dynamic>,
2020-04-06 11:47:34 +02:00
lhs: &Expr,
rhs: &Expr,
level: usize,
) -> Result<Dynamic, Box<EvalAltResult>> {
2020-06-01 09:25:22 +02:00
self.inc_operations(state)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(rhs.position()))?;
let lhs_value = self.eval_expr(scope, mods, state, lib, this_ptr, lhs, level)?;
let rhs_value = self.eval_expr(scope, mods, state, lib, this_ptr, rhs, level)?;
2020-04-06 11:47:34 +02:00
2020-04-12 17:00:06 +02:00
match rhs_value {
#[cfg(not(feature = "no_index"))]
2020-05-11 17:48:50 +02:00
Dynamic(Union::Array(mut rhs_value)) => {
2020-05-09 10:21:11 +02:00
let op = "==";
2020-04-12 17:00:06 +02:00
2020-05-06 17:52:47 +02:00
// Call the `==` operator to compare each value
let def_value = Some(false.into());
2020-05-11 17:48:50 +02:00
for value in rhs_value.iter_mut() {
2020-05-24 05:57:46 +02:00
let args = &mut [&mut lhs_value.clone(), value];
2020-05-09 10:15:50 +02:00
2020-07-30 12:18:28 +02:00
// Qualifiers (none) + function name + number of arguments + argument `TypeId`'s.
let hash =
calc_fn_hash(empty(), op, args.len(), args.iter().map(|a| a.type_id()));
2020-04-30 16:52:36 +02:00
2020-07-31 06:11:16 +02:00
if self
.call_native_fn(state, lib, op, hash, args, false, false, &def_value)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(rhs.position()))?
2020-07-31 06:11:16 +02:00
.0
.as_bool()
.unwrap_or(false)
{
2020-04-30 16:52:36 +02:00
return Ok(true.into());
2020-04-12 17:00:06 +02:00
}
2020-04-06 11:47:34 +02:00
}
Ok(def_value.unwrap())
2020-04-10 06:16:39 +02:00
}
#[cfg(not(feature = "no_object"))]
2020-04-30 16:52:36 +02:00
Dynamic(Union::Map(rhs_value)) => match lhs_value {
2020-04-12 17:00:06 +02:00
// Only allows String or char
Dynamic(Union::Str(s)) => Ok(rhs_value.contains_key(&s).into()),
Dynamic(Union::Char(c)) => Ok(rhs_value.contains_key(&c.to_string()).into()),
2020-08-06 04:17:32 +02:00
_ => EvalAltResult::ErrorInExpr(lhs.position()).into(),
2020-04-30 16:52:36 +02:00
},
Dynamic(Union::Str(rhs_value)) => match lhs_value {
2020-04-12 17:00:06 +02:00
// Only allows String or char
2020-05-17 16:19:49 +02:00
Dynamic(Union::Str(s)) => Ok(rhs_value.contains(s.as_str()).into()),
2020-04-30 16:52:36 +02:00
Dynamic(Union::Char(c)) => Ok(rhs_value.contains(c).into()),
2020-08-06 04:17:32 +02:00
_ => EvalAltResult::ErrorInExpr(lhs.position()).into(),
2020-04-30 16:52:36 +02:00
},
2020-08-06 04:17:32 +02:00
_ => EvalAltResult::ErrorInExpr(rhs.position()).into(),
2020-04-06 11:47:34 +02:00
}
}
/// Evaluate an expression
pub(crate) fn eval_expr(
&self,
2020-03-27 07:34:01 +01:00
scope: &mut Scope,
mods: &mut Imports,
2020-04-28 17:05:03 +02:00
state: &mut State,
2020-10-20 04:54:32 +02:00
lib: &[&Module],
2020-06-26 04:39:18 +02:00
this_ptr: &mut Option<&mut Dynamic>,
2020-03-27 07:34:01 +01:00
expr: &Expr,
level: usize,
) -> Result<Dynamic, Box<EvalAltResult>> {
2020-06-01 09:25:22 +02:00
self.inc_operations(state)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(expr.position()))?;
2020-06-13 18:09:16 +02:00
let result = match expr {
Expr::Expr(x) => self.eval_expr(scope, mods, state, lib, this_ptr, x.as_ref(), level),
2020-05-30 04:27:48 +02:00
Expr::IntegerConstant(x) => Ok(x.0.into()),
2020-04-12 17:00:06 +02:00
#[cfg(not(feature = "no_float"))]
Expr::FloatConstant(x) => Ok(x.0.into()),
Expr::StringConstant(x) => Ok(x.0.to_string().into()),
Expr::CharConstant(x) => Ok(x.0.into()),
2020-07-22 17:12:09 +02:00
Expr::FnPointer(x) => Ok(FnPtr::new_unchecked(x.0.clone(), Default::default()).into()),
2020-06-26 04:39:18 +02:00
Expr::Variable(x) if (x.0).0 == KEYWORD_THIS => {
2020-07-21 16:32:24 +02:00
if let Some(val) = this_ptr {
Ok(val.clone())
2020-06-26 04:39:18 +02:00
} else {
2020-08-06 04:17:32 +02:00
EvalAltResult::ErrorUnboundThis((x.0).1).into()
2020-06-26 04:39:18 +02:00
}
}
Expr::Variable(_) => {
2020-10-11 15:58:11 +02:00
let (val, _, _, _) =
self.search_namespace(scope, mods, state, lib, this_ptr, expr)?;
Ok(val.take_or_clone())
2020-05-04 11:43:54 +02:00
}
Expr::Property(_) => unreachable!(),
2020-03-07 03:39:00 +01:00
// Statement block
Expr::Stmt(x) => self.eval_stmt(scope, mods, state, lib, this_ptr, &x.0, level),
2020-03-07 03:39:00 +01:00
// var op= rhs
Expr::Assignment(x) if x.0.get_variable_access(false).is_some() => {
let (lhs_expr, op, rhs_expr, op_pos) = x.as_ref();
2020-10-11 15:58:11 +02:00
let mut rhs_val = self
.eval_expr(scope, mods, state, lib, this_ptr, rhs_expr, level)?
.flatten();
let (mut lhs_ptr, name, typ, pos) =
self.search_namespace(scope, mods, state, lib, this_ptr, lhs_expr)?;
if !lhs_ptr.is_ref() {
return EvalAltResult::ErrorAssignmentToConstant(name.to_string(), pos).into();
}
2020-06-01 09:25:22 +02:00
self.inc_operations(state)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(pos))?;
match typ {
// Assignment to constant variable
ScopeEntryType::Constant => Err(Box::new(
EvalAltResult::ErrorAssignmentToConstant(name.to_string(), pos),
)),
// Normal assignment
ScopeEntryType::Normal if op.is_empty() => {
2020-08-03 06:10:20 +02:00
if cfg!(not(feature = "no_closure")) && lhs_ptr.is_shared() {
2020-10-11 15:58:11 +02:00
*lhs_ptr.as_mut().write_lock::<Dynamic>().unwrap() = rhs_val;
} else {
2020-10-11 15:58:11 +02:00
*lhs_ptr.as_mut() = rhs_val;
2020-07-31 10:39:38 +02:00
}
Ok(Default::default())
}
// Op-assignment - in order of precedence:
ScopeEntryType::Normal => {
// 1) Native registered overriding function
// 2) Built-in implementation
// 3) Map to `var = var op rhs`
// Qualifiers (none) + function name + number of arguments + argument `TypeId`'s.
2020-10-11 15:58:11 +02:00
let arg_types =
once(lhs_ptr.as_mut().type_id()).chain(once(rhs_val.type_id()));
let hash_fn = calc_fn_hash(empty(), op, 2, arg_types);
2020-09-21 10:15:52 +02:00
match self
.global_module
.get_fn(hash_fn, false)
.or_else(|| self.packages.get_fn(hash_fn, false))
{
2020-09-21 10:15:52 +02:00
// op= function registered as method
Some(func) if func.is_method() => {
let mut lock_guard;
let lhs_ptr_inner;
if cfg!(not(feature = "no_closure")) && lhs_ptr.is_shared() {
2020-10-11 15:58:11 +02:00
lock_guard = lhs_ptr.as_mut().write_lock::<Dynamic>().unwrap();
2020-09-21 10:15:52 +02:00
lhs_ptr_inner = lock_guard.deref_mut();
} else {
2020-10-11 15:58:11 +02:00
lhs_ptr_inner = lhs_ptr.as_mut();
2020-09-21 10:15:52 +02:00
}
let args = &mut [lhs_ptr_inner, &mut rhs_val];
2020-07-31 10:39:38 +02:00
// Overriding exact implementation
2020-09-21 10:15:52 +02:00
if func.is_plugin_fn() {
func.get_plugin_fn().call((self, lib).into(), args)?;
2020-09-21 10:15:52 +02:00
} else {
func.get_native_fn()((self, lib).into(), args)?;
2020-09-21 10:15:52 +02:00
}
}
2020-09-21 10:15:52 +02:00
// Built-in op-assignment function
2020-10-11 15:58:11 +02:00
_ if run_builtin_op_assignment(op, lhs_ptr.as_mut(), &rhs_val)?
.is_some() => {}
2020-09-21 10:15:52 +02:00
// Not built-in: expand to `var = var op rhs`
_ => {
let op = &op[..op.len() - 1]; // extract operator without =
2020-07-30 12:18:28 +02:00
2020-09-21 10:15:52 +02:00
// Clone the LHS value
2020-10-11 15:58:11 +02:00
let args = &mut [&mut lhs_ptr.as_mut().clone(), &mut rhs_val];
2020-07-30 12:18:28 +02:00
2020-09-21 10:15:52 +02:00
// Run function
let (value, _) = self
.exec_fn_call(
state, lib, op, 0, args, false, false, false, None, &None,
2020-09-21 10:15:52 +02:00
level,
)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*op_pos))?;
2020-09-21 10:15:52 +02:00
let value = value.flatten();
if cfg!(not(feature = "no_closure")) && lhs_ptr.is_shared() {
2020-10-11 15:58:11 +02:00
*lhs_ptr.as_mut().write_lock::<Dynamic>().unwrap() = value;
2020-09-21 10:15:52 +02:00
} else {
2020-10-11 15:58:11 +02:00
*lhs_ptr.as_mut() = value;
2020-09-21 10:15:52 +02:00
}
2020-07-31 10:39:38 +02:00
}
2020-05-25 14:14:31 +02:00
}
Ok(Default::default())
2020-05-04 11:43:54 +02:00
}
}
}
// lhs op= rhs
Expr::Assignment(x) => {
let (lhs_expr, op, rhs_expr, op_pos) = x.as_ref();
let mut rhs_val =
self.eval_expr(scope, mods, state, lib, this_ptr, rhs_expr, level)?;
2020-10-05 07:45:57 +02:00
let _new_val = if op.is_empty() {
// Normal assignment
2020-10-05 07:45:57 +02:00
Some((rhs_val, rhs_expr.position()))
2020-05-25 14:14:31 +02:00
} else {
// Op-assignment - always map to `lhs = lhs op rhs`
let op = &op[..op.len() - 1]; // extract operator without =
let args = &mut [
&mut self.eval_expr(scope, mods, state, lib, this_ptr, lhs_expr, level)?,
&mut rhs_val,
];
2020-10-03 17:27:30 +02:00
let result = self
.exec_fn_call(
state, lib, op, 0, args, false, false, false, None, &None, level,
)
.map(|(v, _)| v)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*op_pos))?;
2020-10-03 17:27:30 +02:00
2020-10-05 07:45:57 +02:00
Some((result, rhs_expr.position()))
2020-10-03 17:27:30 +02:00
};
2020-05-25 14:14:31 +02:00
// Must be either `var[index] op= val` or `var.prop op= val`
match lhs_expr {
// name op= rhs (handled above)
Expr::Variable(_) => unreachable!(),
// idx_lhs[idx_expr] op= rhs
#[cfg(not(feature = "no_index"))]
Expr::Index(_) => {
self.eval_dot_index_chain(
2020-10-05 07:45:57 +02:00
scope, mods, state, lib, this_ptr, lhs_expr, level, _new_val,
)?;
Ok(Default::default())
}
// dot_lhs.dot_rhs op= rhs
#[cfg(not(feature = "no_object"))]
Expr::Dot(_) => {
self.eval_dot_index_chain(
2020-10-05 07:45:57 +02:00
scope, mods, state, lib, this_ptr, lhs_expr, level, _new_val,
)?;
Ok(Default::default())
}
// Constant expression (should be caught during parsing)
expr if expr.is_constant() => unreachable!(),
2020-08-06 04:17:32 +02:00
// Syntax error
expr => EvalAltResult::ErrorAssignmentToUnknownLHS(expr.position()).into(),
2016-02-29 22:43:45 +01:00
}
}
2020-03-01 17:11:00 +01:00
2020-04-10 06:16:39 +02:00
// lhs[idx_expr]
#[cfg(not(feature = "no_index"))]
2020-10-05 07:45:57 +02:00
Expr::Index(_) => {
self.eval_dot_index_chain(scope, mods, state, lib, this_ptr, expr, level, None)
}
2020-04-10 06:16:39 +02:00
2020-04-26 12:04:07 +02:00
// lhs.dot_rhs
#[cfg(not(feature = "no_object"))]
2020-10-05 07:45:57 +02:00
Expr::Dot(_) => {
self.eval_dot_index_chain(scope, mods, state, lib, this_ptr, expr, level, None)
}
2020-03-01 17:11:00 +01:00
#[cfg(not(feature = "no_index"))]
Expr::Array(x) => Ok(Dynamic(Union::Array(Box::new(
x.0.iter()
.map(|item| self.eval_expr(scope, mods, state, lib, this_ptr, item, level))
2020-04-30 16:52:36 +02:00
.collect::<Result<Vec<_>, _>>()?,
)))),
2020-03-01 17:11:00 +01:00
2020-03-29 17:53:35 +02:00
#[cfg(not(feature = "no_object"))]
Expr::Map(x) => Ok(Dynamic(Union::Map(Box::new(
x.0.iter()
2020-05-09 18:19:13 +02:00
.map(|((key, _), expr)| {
self.eval_expr(scope, mods, state, lib, this_ptr, expr, level)
2020-04-30 16:52:36 +02:00
.map(|val| (key.clone(), val))
})
.collect::<Result<HashMap<_, _>, _>>()?,
)))),
2020-03-29 17:53:35 +02:00
// Normal function call
Expr::FnCall(x) if x.1.is_none() => {
2020-10-22 06:26:44 +02:00
let ((name, native, cap_scope, pos), _, hash, args_expr, def_val) = x.as_ref();
let def_val = def_val.map(Into::<Dynamic>::into);
self.make_function_call(
scope, mods, state, lib, this_ptr, name, args_expr, &def_val, *hash, *native,
2020-10-22 06:26:44 +02:00
false, *cap_scope, level,
2020-05-23 12:59:28 +02:00
)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*pos))
2020-03-04 15:00:01 +01:00
}
2020-03-01 17:11:00 +01:00
// Module-qualified function call
Expr::FnCall(x) if x.1.is_some() => {
let ((name, _, _, pos), modules, hash, args_expr, def_val) = x.as_ref();
self.make_qualified_function_call(
scope, mods, state, lib, this_ptr, modules, name, args_expr, *def_val, *hash,
level,
)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(*pos))
}
Expr::In(x) => self.eval_in_expr(scope, mods, state, lib, this_ptr, &x.0, &x.1, level),
2020-04-06 11:47:34 +02:00
2020-05-09 18:19:13 +02:00
Expr::And(x) => {
let (lhs, rhs, _) = x.as_ref();
Ok((self
.eval_expr(scope, mods, state, lib, this_ptr, lhs, level)?
2020-04-12 17:00:06 +02:00
.as_bool()
2020-10-05 07:45:57 +02:00
.map_err(|err| self.make_type_mismatch_err::<bool>(err, lhs.position()))?
&& // Short-circuit using &&
self
.eval_expr(scope, mods, state, lib, this_ptr, rhs, level)?
2020-04-12 17:00:06 +02:00
.as_bool()
2020-10-05 07:45:57 +02:00
.map_err(|err| self.make_type_mismatch_err::<bool>(err, rhs.position()))?)
2020-05-09 18:19:13 +02:00
.into())
}
2020-03-02 05:08:03 +01:00
2020-05-09 18:19:13 +02:00
Expr::Or(x) => {
let (lhs, rhs, _) = x.as_ref();
Ok((self
.eval_expr(scope, mods, state, lib, this_ptr, lhs, level)?
2020-04-12 17:00:06 +02:00
.as_bool()
2020-10-05 07:45:57 +02:00
.map_err(|err| self.make_type_mismatch_err::<bool>(err, lhs.position()))?
|| // Short-circuit using ||
self
.eval_expr(scope, mods, state, lib, this_ptr, rhs, level)?
2020-04-12 17:00:06 +02:00
.as_bool()
2020-10-05 07:45:57 +02:00
.map_err(|err| self.make_type_mismatch_err::<bool>(err, rhs.position()))?)
2020-05-09 18:19:13 +02:00
.into())
}
2020-03-02 05:08:03 +01:00
Expr::True(_) => Ok(true.into()),
Expr::False(_) => Ok(false.into()),
Expr::Unit(_) => Ok(().into()),
2020-04-10 06:16:39 +02:00
2020-07-09 13:54:28 +02:00
Expr::Custom(x) => {
let func = (x.0).func();
let expressions = (x.0)
.keywords()
.iter()
.map(Into::into)
.collect::<StaticVec<_>>();
2020-07-22 07:08:51 +02:00
let mut context = EvalContext {
2020-10-11 15:58:11 +02:00
engine: self,
scope,
2020-07-22 07:08:51 +02:00
mods,
state,
lib,
this_ptr,
level,
};
func(&mut context, &expressions)
2020-07-09 13:54:28 +02:00
}
2020-05-04 11:43:54 +02:00
_ => unreachable!(),
2020-06-13 18:09:16 +02:00
};
2020-06-14 16:44:59 +02:00
self.check_data_size(result)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(expr.position()))
2016-02-29 22:43:45 +01:00
}
/// Evaluate a statement
///
///
/// # Safety
///
/// This method uses some unsafe code, mainly for avoiding cloning of local variable names via
/// direct lifetime casting.
2020-05-30 04:27:48 +02:00
pub(crate) fn eval_stmt(
&self,
2020-05-30 04:27:48 +02:00
scope: &mut Scope,
mods: &mut Imports,
2020-04-28 17:05:03 +02:00
state: &mut State,
2020-10-20 04:54:32 +02:00
lib: &[&Module],
2020-06-26 04:39:18 +02:00
this_ptr: &mut Option<&mut Dynamic>,
stmt: &Stmt,
2020-03-27 07:34:01 +01:00
level: usize,
) -> Result<Dynamic, Box<EvalAltResult>> {
2020-06-01 09:25:22 +02:00
self.inc_operations(state)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(stmt.position()))?;
2020-06-13 18:09:16 +02:00
let result = match stmt {
2020-03-09 14:57:07 +01:00
// No-op
2020-04-30 16:52:36 +02:00
Stmt::Noop(_) => Ok(Default::default()),
2020-03-09 14:57:07 +01:00
2020-03-06 16:49:52 +01:00
// Expression as statement
Stmt::Expr(expr) => self.eval_expr(scope, mods, state, lib, this_ptr, expr, level),
2020-03-01 17:11:00 +01:00
2020-03-06 16:49:52 +01:00
// Block scope
2020-10-27 11:18:19 +01:00
Stmt::Block(statements, _) => {
let prev_scope_len = scope.len();
let prev_mods_len = mods.len();
state.scope_level += 1;
2016-02-29 22:43:45 +01:00
2020-10-27 11:18:19 +01:00
let result = statements.iter().try_fold(Default::default(), |_, stmt| {
self.eval_stmt(scope, mods, state, lib, this_ptr, stmt, level)
2020-03-27 07:34:01 +01:00
});
2016-02-29 22:43:45 +01:00
scope.rewind(prev_scope_len);
mods.truncate(prev_mods_len);
state.scope_level -= 1;
2016-02-29 22:43:45 +01:00
2020-04-28 17:05:03 +02:00
// The impact of an eval statement goes away at the end of a block
// because any new variables introduced will go out of scope
state.always_search = false;
2020-03-16 16:51:32 +01:00
result
2016-02-29 22:43:45 +01:00
}
2020-03-01 17:11:00 +01:00
2020-03-06 16:49:52 +01:00
// If-else statement
2020-10-27 12:23:43 +01:00
Stmt::IfThenElse(expr, x, _) => {
let (if_block, else_block) = x.as_ref();
self.eval_expr(scope, mods, state, lib, this_ptr, expr, level)?
.as_bool()
.map_err(|err| self.make_type_mismatch_err::<bool>(err, expr.position()))
.and_then(|guard_val| {
if guard_val {
self.eval_stmt(scope, mods, state, lib, this_ptr, if_block, level)
} else if let Some(stmt) = else_block {
self.eval_stmt(scope, mods, state, lib, this_ptr, stmt, level)
} else {
Ok(Default::default())
}
})
}
2020-03-01 17:11:00 +01:00
2020-03-06 16:49:52 +01:00
// While loop
2020-10-27 11:18:19 +01:00
Stmt::While(expr, body, _) => loop {
2020-06-26 04:39:18 +02:00
match self
.eval_expr(scope, mods, state, lib, this_ptr, expr, level)?
2020-06-26 04:39:18 +02:00
.as_bool()
{
Ok(true) => {
match self.eval_stmt(scope, mods, state, lib, this_ptr, body, level) {
Ok(_) => (),
Err(err) => match *err {
2020-10-17 10:34:07 +02:00
EvalAltResult::LoopBreak(false, _) => (),
EvalAltResult::LoopBreak(true, _) => return Ok(Default::default()),
_ => return Err(err),
},
}
}
2020-04-30 16:52:36 +02:00
Ok(false) => return Ok(Default::default()),
2020-10-05 07:45:57 +02:00
Err(err) => {
return Err(self.make_type_mismatch_err::<bool>(err, expr.position()))
}
2016-02-29 22:43:45 +01:00
}
2017-12-20 12:16:14 +01:00
},
2020-03-01 17:11:00 +01:00
2020-03-06 16:49:52 +01:00
// Loop statement
2020-10-27 11:18:19 +01:00
Stmt::Loop(block, _) => loop {
match self.eval_stmt(scope, mods, state, lib, this_ptr, block, level) {
2020-05-17 16:19:49 +02:00
Ok(_) => (),
Err(err) => match *err {
2020-10-17 10:34:07 +02:00
EvalAltResult::LoopBreak(false, _) => (),
EvalAltResult::LoopBreak(true, _) => return Ok(Default::default()),
_ => return Err(err),
},
2017-10-30 16:08:44 +01:00
}
2017-12-20 12:16:14 +01:00
},
2020-03-01 17:11:00 +01:00
2020-03-06 16:49:52 +01:00
// For loop
2020-10-27 12:23:43 +01:00
Stmt::For(expr, x, _) => {
let (name, stmt) = x.as_ref();
2020-10-14 17:22:10 +02:00
let iter_obj = self.eval_expr(scope, mods, state, lib, this_ptr, expr, level)?;
let iter_type = iter_obj.type_id();
2020-03-01 17:11:00 +01:00
2020-10-14 17:22:10 +02:00
let func = self
2020-05-13 13:21:42 +02:00
.global_module
2020-10-14 17:22:10 +02:00
.get_iter(iter_type)
.or_else(|| self.packages.get_iter(iter_type));
if let Some(func) = func {
2020-04-24 16:54:56 +02:00
// Add the loop variable
let var_name = unsafe_cast_var_name_to_lifetime(name, &state);
scope.push(var_name, ());
2020-04-27 16:49:09 +02:00
let index = scope.len() - 1;
state.scope_level += 1;
2020-03-01 17:11:00 +01:00
2020-10-14 17:22:10 +02:00
for iter_value in func(iter_obj) {
2020-08-08 10:24:10 +02:00
let (loop_var, _) = scope.get_mut(index);
2020-08-03 17:11:38 +02:00
2020-08-08 10:24:10 +02:00
let value = iter_value.flatten();
if cfg!(not(feature = "no_closure")) && loop_var.is_shared() {
*loop_var.write_lock().unwrap() = value;
2020-08-03 17:11:38 +02:00
} else {
2020-08-08 10:24:10 +02:00
*loop_var = value;
2020-08-03 17:11:38 +02:00
}
2020-06-01 09:25:22 +02:00
self.inc_operations(state)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(stmt.position()))?;
2020-03-01 17:11:00 +01:00
match self.eval_stmt(scope, mods, state, lib, this_ptr, stmt, level) {
Ok(_) => (),
Err(err) => match *err {
2020-10-17 10:34:07 +02:00
EvalAltResult::LoopBreak(false, _) => (),
EvalAltResult::LoopBreak(true, _) => break,
_ => return Err(err),
},
}
}
2020-04-11 12:09:03 +02:00
state.scope_level -= 1;
2020-10-21 08:45:10 +02:00
scope.rewind(scope.len() - 1);
2020-04-30 16:52:36 +02:00
Ok(Default::default())
} else {
2020-10-27 11:18:19 +01:00
EvalAltResult::ErrorFor(expr.position()).into()
}
}
2020-03-01 17:11:00 +01:00
2020-04-01 10:22:18 +02:00
// Continue statement
2020-10-17 10:34:07 +02:00
Stmt::Continue(pos) => EvalAltResult::LoopBreak(false, *pos).into(),
2020-04-01 10:22:18 +02:00
2020-03-06 16:49:52 +01:00
// Break statement
2020-10-17 10:34:07 +02:00
Stmt::Break(pos) => EvalAltResult::LoopBreak(true, *pos).into(),
2020-03-01 17:11:00 +01:00
2020-10-20 17:16:03 +02:00
// Try/Catch statement
Stmt::TryCatch(x) => {
2020-10-27 11:18:19 +01:00
let ((try_body, _), var_def, (catch_body, _)) = x.as_ref();
2020-10-20 17:16:03 +02:00
let result = self
2020-10-27 11:18:19 +01:00
.eval_stmt(scope, mods, state, lib, this_ptr, try_body, level)
2020-10-20 17:16:03 +02:00
.map(|_| ().into());
2020-10-21 08:45:10 +02:00
match result {
Ok(_) => result,
Err(err) => match *err {
2020-10-20 17:16:03 +02:00
mut err @ EvalAltResult::ErrorRuntime(_, _) | mut err
if err.catchable() =>
{
2020-10-21 08:45:10 +02:00
let value = if let EvalAltResult::ErrorRuntime(ref x, _) = err {
x.clone()
} else {
err.set_position(Position::none());
err.to_string().into()
2020-10-20 17:16:03 +02:00
};
2020-10-21 08:45:10 +02:00
let orig_scope_len = scope.len();
state.scope_level += 1;
if let Some((var_name, _)) = var_def {
2020-10-20 17:16:03 +02:00
let var_name = unsafe_cast_var_name_to_lifetime(var_name, &state);
scope.push(var_name, value);
2020-10-21 08:45:10 +02:00
}
2020-10-20 17:16:03 +02:00
let mut result = self
.eval_stmt(scope, mods, state, lib, this_ptr, catch_body, level)
.map(|_| ().into());
if let Some(result_err) = result.as_ref().err() {
2020-10-21 08:45:10 +02:00
if let EvalAltResult::ErrorRuntime(Dynamic(Union::Unit(_)), pos) =
result_err.as_ref()
{
err.set_position(*pos);
result = Err(Box::new(err));
2020-10-20 17:16:03 +02:00
}
}
2020-10-21 08:45:10 +02:00
state.scope_level -= 1;
scope.rewind(orig_scope_len);
2020-10-20 17:16:03 +02:00
result
}
_ => Err(err),
2020-10-21 08:45:10 +02:00
},
2020-10-20 17:16:03 +02:00
}
}
2020-03-03 11:15:20 +01:00
// Return value
2020-10-27 11:18:19 +01:00
Stmt::ReturnWithVal((ReturnType::Return, pos), Some(expr), _) => EvalAltResult::Return(
self.eval_expr(scope, mods, state, lib, this_ptr, expr, level)?,
*pos,
)
.into(),
2020-03-03 11:15:20 +01:00
// Empty return
2020-10-27 11:18:19 +01:00
Stmt::ReturnWithVal((ReturnType::Return, pos), None, _) => {
EvalAltResult::Return(Default::default(), *pos).into()
2020-03-03 11:15:20 +01:00
}
2020-03-01 17:11:00 +01:00
2020-03-03 11:15:20 +01:00
// Throw value
2020-10-27 11:18:19 +01:00
Stmt::ReturnWithVal((ReturnType::Exception, pos), Some(expr), _) => {
let val = self.eval_expr(scope, mods, state, lib, this_ptr, expr, level)?;
2020-10-27 11:18:19 +01:00
EvalAltResult::ErrorRuntime(val, *pos).into()
}
2020-03-01 17:11:00 +01:00
// Empty throw
2020-10-27 11:18:19 +01:00
Stmt::ReturnWithVal((ReturnType::Exception, pos), None, _) => {
EvalAltResult::ErrorRuntime(().into(), *pos).into()
}
2020-10-09 07:25:53 +02:00
// Let/const statement
2020-10-27 11:18:19 +01:00
Stmt::Let(var_def, expr, _) | Stmt::Const(var_def, expr, _) => {
2020-10-09 07:25:53 +02:00
let entry_type = match stmt {
2020-10-27 11:18:19 +01:00
Stmt::Let(_, _, _) => ScopeEntryType::Normal,
Stmt::Const(_, _, _) => ScopeEntryType::Constant,
2020-10-09 07:25:53 +02:00
_ => unreachable!(),
};
2020-03-13 11:12:41 +01:00
2020-10-09 07:25:53 +02:00
let val = if let Some(expr) = expr {
self.eval_expr(scope, mods, state, lib, this_ptr, expr, level)?
.flatten()
2020-10-09 05:15:25 +02:00
} else {
().into()
};
2020-10-27 11:18:19 +01:00
let var_name = unsafe_cast_var_name_to_lifetime(&var_def.0, &state);
2020-10-09 07:25:53 +02:00
scope.push_dynamic_value(var_name, entry_type, val, false);
2020-04-30 16:52:36 +02:00
Ok(Default::default())
2020-03-13 11:12:41 +01:00
}
2020-05-04 13:36:58 +02:00
// Import statement
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_module"))]
2020-10-27 11:18:19 +01:00
Stmt::Import(expr, alias, _pos) => {
// Guard against too many modules
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "unchecked"))]
if state.modules >= self.max_modules() {
2020-08-06 04:17:32 +02:00
return EvalAltResult::ErrorTooManyModules(*_pos).into();
}
2020-05-15 15:40:54 +02:00
if let Some(path) = self
.eval_expr(scope, mods, state, lib, this_ptr, &expr, level)?
.try_cast::<ImmutableString>()
{
2020-07-04 16:53:00 +02:00
if let Some(resolver) = &self.module_resolver {
let mut module = resolver.resolve(self, &path, expr.position())?;
2020-10-27 12:23:43 +01:00
if let Some(name_def) = alias {
module.index_all_sub_modules();
2020-10-27 12:23:43 +01:00
mods.push((name_def.0.clone(), module));
}
2020-05-15 15:40:54 +02:00
2020-07-04 16:53:00 +02:00
state.modules += 1;
2020-05-15 15:40:54 +02:00
2020-07-04 16:53:00 +02:00
Ok(Default::default())
} else {
2020-08-06 04:17:32 +02:00
Err(
EvalAltResult::ErrorModuleNotFound(path.to_string(), expr.position())
.into(),
)
}
} else {
2020-10-05 07:45:57 +02:00
Err(self.make_type_mismatch_err::<ImmutableString>("", expr.position()))
2020-05-04 13:36:58 +02:00
}
}
2020-05-08 10:49:24 +02:00
// Export statement
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "no_module"))]
2020-10-27 11:18:19 +01:00
Stmt::Export(list, _) => {
for ((id, id_pos), rename) in list.iter() {
2020-05-08 10:49:24 +02:00
// Mark scope variables as public
if let Some(index) = scope.get_index(id).map(|(i, _)| i) {
2020-07-21 16:32:24 +02:00
let alias = rename.as_ref().map(|(n, _)| n).unwrap_or_else(|| id);
scope.set_entry_alias(index, alias.clone());
2020-05-11 17:48:50 +02:00
} else {
2020-08-06 04:17:32 +02:00
return EvalAltResult::ErrorVariableNotFound(id.into(), *id_pos).into();
2020-05-08 10:49:24 +02:00
}
}
Ok(Default::default())
}
2020-08-03 06:10:20 +02:00
// Share statement
#[cfg(not(feature = "no_closure"))]
2020-10-27 11:18:19 +01:00
Stmt::Share(var_name, _) => {
2020-08-03 06:10:20 +02:00
match scope.get_index(var_name) {
Some((index, ScopeEntryType::Normal)) => {
let (val, _) = scope.get_mut(index);
if !val.is_shared() {
// Replace the variable with a shared value.
*val = mem::take(val).into_shared();
}
}
_ => (),
}
Ok(Default::default())
}
2020-06-13 18:09:16 +02:00
};
2020-06-14 16:44:59 +02:00
self.check_data_size(result)
2020-10-11 15:58:11 +02:00
.map_err(|err| err.fill_position(stmt.position()))
2020-06-13 18:09:16 +02:00
}
2020-07-31 16:30:23 +02:00
/// Check a result to ensure that the data size is within allowable limit.
/// Position in `EvalAltResult` may be None and should be set afterwards.
2020-07-26 09:53:22 +02:00
#[cfg(feature = "unchecked")]
#[inline(always)]
fn check_data_size(
&self,
result: Result<Dynamic, Box<EvalAltResult>>,
) -> Result<Dynamic, Box<EvalAltResult>> {
2020-07-31 16:30:23 +02:00
result
2020-07-26 09:53:22 +02:00
}
2020-06-14 16:44:59 +02:00
/// Check a result to ensure that the data size is within allowable limit.
2020-06-29 17:55:28 +02:00
/// Position in `EvalAltResult` may be None and should be set afterwards.
2020-07-26 09:53:22 +02:00
#[cfg(not(feature = "unchecked"))]
2020-06-14 16:44:59 +02:00
fn check_data_size(
&self,
result: Result<Dynamic, Box<EvalAltResult>>,
) -> Result<Dynamic, Box<EvalAltResult>> {
// If no data size limits, just return
let mut total = 0;
total += self.max_string_size();
#[cfg(not(feature = "no_index"))]
2020-07-26 09:53:22 +02:00
{
total += self.max_array_size();
}
#[cfg(not(feature = "no_object"))]
{
total += self.max_map_size();
}
if total == 0 {
2020-06-14 16:44:59 +02:00
return result;
2020-06-14 08:25:47 +02:00
}
// Recursively calculate the size of a value (especially `Array` and `Map`)
fn calc_size(value: &Dynamic) -> (usize, usize, usize) {
match value {
#[cfg(not(feature = "no_index"))]
Dynamic(Union::Array(arr)) => {
let mut arrays = 0;
let mut maps = 0;
arr.iter().for_each(|value| match value {
2020-07-01 16:21:43 +02:00
Dynamic(Union::Array(_)) => {
let (a, m, _) = calc_size(value);
arrays += a;
maps += m;
}
#[cfg(not(feature = "no_object"))]
Dynamic(Union::Map(_)) => {
2020-06-14 08:25:47 +02:00
let (a, m, _) = calc_size(value);
arrays += a;
maps += m;
}
_ => arrays += 1,
});
(arrays, maps, 0)
}
#[cfg(not(feature = "no_object"))]
Dynamic(Union::Map(map)) => {
let mut arrays = 0;
let mut maps = 0;
map.values().for_each(|value| match value {
2020-07-01 16:21:43 +02:00
#[cfg(not(feature = "no_index"))]
Dynamic(Union::Array(_)) => {
let (a, m, _) = calc_size(value);
arrays += a;
maps += m;
}
Dynamic(Union::Map(_)) => {
2020-06-14 08:25:47 +02:00
let (a, m, _) = calc_size(value);
arrays += a;
maps += m;
}
_ => maps += 1,
});
(arrays, maps, 0)
}
Dynamic(Union::Str(s)) => (0, 0, s.len()),
_ => (0, 0, 0),
2020-06-13 18:09:16 +02:00
}
2020-06-14 08:25:47 +02:00
}
2020-06-14 16:44:59 +02:00
match result {
// Simply return all errors
Err(_) => return result,
// String with limit
Ok(Dynamic(Union::Str(_))) if self.max_string_size() > 0 => (),
2020-06-14 16:44:59 +02:00
// Array with limit
2020-06-13 18:09:16 +02:00
#[cfg(not(feature = "no_index"))]
Ok(Dynamic(Union::Array(_))) if self.max_array_size() > 0 => (),
2020-06-14 16:44:59 +02:00
// Map with limit
2020-06-13 18:09:16 +02:00
#[cfg(not(feature = "no_object"))]
Ok(Dynamic(Union::Map(_))) if self.max_map_size() > 0 => (),
2020-06-14 16:44:59 +02:00
// Everything else is simply returned
Ok(_) => return result,
2020-06-14 08:25:47 +02:00
};
let (_arr, _map, s) = calc_size(result.as_ref().unwrap());
2020-06-14 08:25:47 +02:00
if s > self.max_string_size() {
return EvalAltResult::ErrorDataTooLarge(
2020-06-14 08:25:47 +02:00
"Length of string".to_string(),
self.max_string_size(),
2020-06-14 08:25:47 +02:00
s,
Position::none(),
2020-08-06 04:17:32 +02:00
)
.into();
}
#[cfg(not(feature = "no_index"))]
if _arr > self.max_array_size() {
return EvalAltResult::ErrorDataTooLarge(
"Size of array".to_string(),
self.max_array_size(),
_arr,
2020-06-14 08:25:47 +02:00
Position::none(),
2020-08-06 04:17:32 +02:00
)
.into();
}
#[cfg(not(feature = "no_object"))]
if _map > self.max_map_size() {
return EvalAltResult::ErrorDataTooLarge(
2020-06-14 08:25:47 +02:00
"Number of properties in object map".to_string(),
self.max_map_size(),
_map,
2020-06-14 08:25:47 +02:00
Position::none(),
2020-08-06 04:17:32 +02:00
)
.into();
2016-02-29 22:43:45 +01:00
}
result
2016-02-29 22:43:45 +01:00
}
/// Check if the number of operations stay within limit.
/// Position in `EvalAltResult` is `None` and must be set afterwards.
pub(crate) fn inc_operations(&self, state: &mut State) -> Result<(), Box<EvalAltResult>> {
state.operations += 1;
#[cfg(not(feature = "unchecked"))]
2020-07-04 16:53:00 +02:00
// Guard against too many operations
if self.max_operations() > 0 && state.operations > self.max_operations() {
2020-08-06 04:17:32 +02:00
return EvalAltResult::ErrorTooManyOperations(Position::none()).into();
}
// Report progress - only in steps
2020-05-17 16:19:49 +02:00
if let Some(progress) = &self.progress {
2020-06-02 07:33:16 +02:00
if !progress(&state.operations) {
// Terminate script if progress returns false
2020-08-06 04:17:32 +02:00
return EvalAltResult::ErrorTerminated(Position::none()).into();
}
}
Ok(())
}
/// Map a type_name into a pretty-print name
2020-08-08 10:24:10 +02:00
#[inline(always)]
2020-03-03 09:24:03 +01:00
pub(crate) fn map_type_name<'a>(&'a self, name: &'a str) -> &'a str {
2020-04-11 12:09:03 +02:00
self.type_names
2020-10-25 14:57:18 +01:00
.get(name)
.map(String::as_str)
2020-09-20 20:07:43 +02:00
.unwrap_or_else(|| map_std_type_name(name))
2020-03-02 16:16:19 +01:00
}
2020-10-05 07:45:57 +02:00
/// Make a Box<EvalAltResult<ErrorMismatchDataType>>.
2020-10-08 16:25:50 +02:00
#[inline(always)]
2020-10-27 04:30:38 +01:00
pub(crate) fn make_type_mismatch_err<T>(&self, typ: &str, pos: Position) -> Box<EvalAltResult> {
2020-10-05 07:45:57 +02:00
EvalAltResult::ErrorMismatchDataType(
typ.into(),
self.map_type_name(type_name::<T>()).into(),
pos,
)
.into()
}
2016-03-01 15:40:48 +01:00
}