Struct ZendCallable

Source

pub struct ZendCallable<'a>(/* private fields */);

Expand description

Acts as a wrapper around a callable Zval. Allows the owner to call the Zval as if it was a PHP function through the try_call method.

Implementations§

Source §

impl<'a> ZendCallable<'a>

Source

pub fn new(callable: &'a Zval) -> Result<Self>

Attempts to create a new ZendCallable from a zval.

§Parameters

callable - The underlying Zval that is callable.

§Errors

Returns an error if the Zval was not callable.

Source

pub fn new_owned(callable: Zval) -> Result<Self>

Attempts to create a new ZendCallable by taking ownership of a Zval. Returns a result containing the callable if the zval was callable.

§Parameters

callable - The underlying Zval that is callable.

§Errors

Error::Callable - If the zval was not callable.

Source

pub fn try_from_name(name: &str) -> Result<Self>

Attempts to create a new ZendCallable from a function name. Returns a result containing the callable if the function existed and was callable.

§Parameters

name - Name of the callable function.

§Errors

Returns an error if the function does not exist or is not callable.

§Example

use ext_php_rs::types::ZendCallable;

let strpos = ZendCallable::try_from_name("strpos").unwrap();
let result = strpos.try_call(vec![&"hello", &"e"]).unwrap();
assert_eq!(result.long(), Some(1));

Source

pub fn try_call(&self, params: Vec<&dyn IntoZvalDyn>) -> Result<Zval>

Attempts to call the callable with a list of arguments to pass to the function.

You should not call this function directly, rather through the call_user_func macro.

§Parameters

params - A list of parameters to call the function with.

§Returns

Returns the result wrapped in Ok upon success.

§Errors

If calling the callable fails, or an exception is thrown, an Err is returned.
If the number of parameters exceeds u32::MAX.

§Example

use ext_php_rs::types::ZendCallable;

let strpos = ZendCallable::try_from_name("strpos").unwrap();
let result = strpos.try_call(vec![&"hello", &"e"]).unwrap();
assert_eq!(result.long(), Some(1));