Struct rhai::FnPtr

source · [−]

pub struct FnPtr { /* private fields */ }

Expand description

A general function pointer, which may carry additional (i.e. curried) argument values to be passed onto a function during a call.

Implementations

source

impl FnPtr

source

pub fn num_curried(&self) -> usize

👎Deprecated since 1.8.0:

use curry().len() instead

Get the number of curried arguments.

Deprecated

This method is deprecated. Use curry().len() instead.

This method will be removed in the next major version.

source

pub fn call_dynamic(
 &self,
 context: &NativeCallContext<'_>,
 this_ptr: Option<&mut Dynamic>,
 arg_values: impl AsMut<[Dynamic]>
) -> Result<Dynamic, Box<EvalAltResult>>

👎Deprecated since 1.3.0:

use call_within_context or call_raw instead

Call the function pointer with curried arguments (if any). The function may be script-defined (not available under no_function) or native Rust.

This method is intended for calling a function pointer that is passed into a native Rust function as an argument. Therefore, the AST is NOT evaluated before calling the function.

Deprecated

This method is deprecated. Use call_within_context or call_raw instead.

This method will be removed in the next major version.

source

impl FnPtr

source

pub fn new(name: impl Into<Identifier>) -> Result<Self, Box<EvalAltResult>>

Create a new function pointer.

source

pub fn fn_name(&self) -> &str

Get the name of the function.

source

pub fn curry(&self) -> &[Dynamic]

Get the curried arguments.

source

pub fn add_curry(&mut self, value: Dynamic) -> &mut Self

Add a new curried argument.

source

pub fn set_curry(
&mut self,
values: impl IntoIterator<Item = Dynamic>
) -> &mut Self

Set curried arguments to the function pointer.

source

pub fn is_curried(&self) -> bool

Is the function pointer curried?

source

pub fn is_anonymous(&self) -> bool

Does the function pointer refer to an anonymous function?

Not available under no_function.

source

pub fn call<T: Variant + Clone>(
 &self,
 engine: &Engine,
 ast: &AST,
 args: impl FuncArgs
) -> Result<T, Box<EvalAltResult>>

Call the function pointer with curried arguments (if any). The function may be script-defined (not available under no_function) or native Rust.

This method is intended for calling a function pointer directly, possibly on another Engine. Therefore, the AST is NOT evaluated before calling the function.

Example

use rhai::{Engine, FnPtr};

let engine = Engine::new();

let ast = engine.compile("fn foo(x, y) { len(x) + y }")?;

let mut fn_ptr = FnPtr::new("foo")?;

// Curry values into the function pointer
fn_ptr.set_curry(vec!["abc".into()]);

// Values are only needed for non-curried parameters
let result: i64 = fn_ptr.call(&engine, &ast, ( 39_i64, ) )?;

assert_eq!(result, 42);

source

pub fn call_within_context<T: Variant + Clone>(
 &self,
 context: &NativeCallContext<'_>,
 args: impl FuncArgs
) -> Result<T, Box<EvalAltResult>>

Call the function pointer with curried arguments (if any). The function may be script-defined (not available under no_function) or native Rust.

This method is intended for calling a function pointer that is passed into a native Rust function as an argument. Therefore, the AST is NOT evaluated before calling the function.

source

pub fn call_raw(
 &self,
 context: &NativeCallContext<'_>,
 this_ptr: Option<&mut Dynamic>,
 arg_values: impl AsMut<[Dynamic]>
) -> Result<Dynamic, Box<EvalAltResult>>

Call the function pointer with curried arguments (if any). The function may be script-defined (not available under no_function) or native Rust.

This method is intended for calling a function pointer that is passed into a native Rust function as an argument. Therefore, the AST is NOT evaluated before calling the function.