Enum rhai::CallableFunction

#[non_exhaustive]
pub enum CallableFunction {
    Pure {
        func: Shared<dyn Fn(Option<NativeCallContext<'_>>, &mut [&'_ mut Dynamic]) -> Result<Dynamic, Box<EvalAltResult>>>,
        has_context: bool,
        is_pure: bool,
    },
    Method {
        func: Shared<dyn Fn(Option<NativeCallContext<'_>>, &mut [&'_ mut Dynamic]) -> Result<Dynamic, Box<EvalAltResult>>>,
        has_context: bool,
        is_pure: bool,
    },
    Iterator {
        func: Shared<dyn Fn(Dynamic) -> Box<dyn Iterator<Item = Result<Dynamic, Box<EvalAltResult>>>>>,
    },
    Plugin {
        func: Shared<dyn PluginFunction>,
    },
    Script {
        fn_def: Shared<ScriptFnDef>,
        environ: Option<Shared<EncapsulatedEnviron>>,
    },
}

(internals) A type encapsulating a function callable by Rhai. Exported under the internals feature only.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Pure

Fields

func: Shared<dyn Fn(Option<NativeCallContext<'_>>, &mut [&'_ mut Dynamic]) -> Result<Dynamic, Box<EvalAltResult>>>

Shared function pointer.

has_context: bool

Does the function take a NativeCallContext parameter?

is_pure: bool

This is a dummy field and is not used.

A pure native Rust function with all arguments passed by value.

Method

Fields

func: Shared<dyn Fn(Option<NativeCallContext<'_>>, &mut [&'_ mut Dynamic]) -> Result<Dynamic, Box<EvalAltResult>>>

Shared function pointer.

has_context: bool

Does the function take a NativeCallContext parameter?

is_pure: bool

Allow operating on constants?

A native Rust object method with the first argument passed by reference, and the rest passed by value.

Iterator

Fields

func: Shared<dyn Fn(Dynamic) -> Box<dyn Iterator<Item = Result<Dynamic, Box<EvalAltResult>>>>>

Shared function pointer.

An iterator function.

Plugin

Fields

func: Shared<dyn PluginFunction>

Shared function pointer.

A plugin function,

Script

Fields

fn_def: Shared<ScriptFnDef>

Shared reference to the ScriptFnDef function definition.

environ: Option<Shared<EncapsulatedEnviron>>

Encapsulated environment, if any.

A script-defined function.

Implementations

impl CallableFunction

pub fn is_pure(&self) -> bool

Is this a pure native Rust function?

pub fn is_method(&self) -> bool

Is this a native Rust method function?

pub const fn is_iter(&self) -> bool

Is this an iterator function?

pub const fn is_script(&self) -> bool

Is this a script-defined function?

pub const fn is_plugin_fn(&self) -> bool

Is this a plugin function?

pub const fn is_native(&self) -> bool

Is this a native Rust function?

pub fn has_context(&self) -> bool

Is there a NativeCallContext parameter?

pub fn access(&self) -> FnAccess

Get the access mode.

pub fn get_native_fn( &self ) -> Option<&Shared<dyn Fn(Option<NativeCallContext<'_>>, &mut [&'_ mut Dynamic]) -> Result<Dynamic, Box<EvalAltResult>>>>

Get a shared reference to a native Rust function.

pub const fn get_script_fn_def(&self) -> Option<&Shared<ScriptFnDef>>

Get a shared reference to a script-defined function definition.

Not available under no_function.

pub fn get_encapsulated_environ(&self) -> Option<&EncapsulatedEnviron>

Get a reference to the shared encapsulated environment of the function definition.

Not available under no_function or no_module.

pub fn get_iter_fn( &self ) -> Option<&dyn Fn(Dynamic) -> Box<dyn Iterator<Item = Result<Dynamic, Box<EvalAltResult>>>>>

Get a reference to an iterator function.

pub fn get_plugin_fn(&self) -> Option<&Shared<dyn PluginFunction>>

Get a shared reference to a plugin function.

Trait Implementations

impl Clone for CallableFunction

fn clone(&self) -> CallableFunction

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CallableFunction

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for CallableFunction

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Rc<ScriptFnDef, Global>> for CallableFunction

fn from(fn_def: Shared<ScriptFnDef>) -> Self

Converts to this type from the input type.

impl From<Rc<dyn PluginFunction, Global>> for CallableFunction

fn from(func: Shared<dyn PluginFunction>) -> Self

Converts to this type from the input type.

impl From<ScriptFnDef> for CallableFunction

fn from(fn_def: ScriptFnDef) -> Self

Converts to this type from the input type.

impl<T: PluginFunction + 'static + SendSync> From<T> for CallableFunction

fn from(func: T) -> Self

Converts to this type from the input type.