Trait IntoZval 

pub trait IntoZval: Sized {
    const TYPE: DataType;
    const NULLABLE: bool;

    // Required method
    fn set_zval(self, zv: &mut Zval, persistent: bool) -> Result<()>;

    // Provided method
    fn into_zval(self, persistent: bool) -> Result<Zval> { ... }
}

Provides implementations for converting Rust primitive types into PHP zvals. Alternative to the built-in Rust From and TryFrom implementations, allowing the caller to specify whether the Zval contents will persist between requests.

Required Associated Constants

const TYPE: DataType

The corresponding type of the implemented value in PHP.

const NULLABLE: bool

Whether converting into a Zval may result in null.

Required Methods

fn set_zval(self, zv: &mut Zval, persistent: bool) -> Result<()>

Sets the content of a pre-existing zval. Returns a result containing nothing if setting the content was successful.

Parameters

• zv - The Zval to set the content of.
• persistent - Whether the contents of the Zval will persist between requests.

Errors

Implementations return the error that describes their failure, for example:

• Error::IntegerOverflow - If the value does not fit in a PHP integer.
• Error::InvalidCString - If a string in the value contains a NUL byte.

Provided Methods

fn into_zval(self, persistent: bool) -> Result<Zval>

Converts a Rust primitive type into a Zval. Returns a result containing the Zval if successful.

Parameters

• persistent - Whether the contents of the Zval will persist between requests.

Errors

Implementations return the error that describes their failure, for example:

• Error::IntegerOverflow - If the value does not fit in a PHP integer.
• Error::InvalidCString - If a string in the value contains a NUL byte.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

impl IntoZval for &str

const TYPE: DataType = DataType::String

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, persistent: bool) -> Result<()>

impl IntoZval for ()

const TYPE: DataType = DataType::Void

const NULLABLE: bool = true

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl IntoZval for String

const TYPE: DataType = DataType::String

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, persistent: bool) -> Result<()>

impl IntoZval for bool

const TYPE: DataType = crate::flags::DataType::Bool

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl IntoZval for f32

const TYPE: DataType = crate::flags::DataType::Double

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl IntoZval for f64

const TYPE: DataType = crate::flags::DataType::Double

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl IntoZval for i8

const TYPE: DataType = crate::flags::DataType::Long

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl IntoZval for i16

const TYPE: DataType = crate::flags::DataType::Long

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl IntoZval for i32

const TYPE: DataType = crate::flags::DataType::Long

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl IntoZval for i64

const TYPE: DataType = DataType::Long

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl IntoZval for isize

const TYPE: DataType = DataType::Long

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl IntoZval for u8

const TYPE: DataType = crate::flags::DataType::Long

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl IntoZval for u16

const TYPE: DataType = crate::flags::DataType::Long

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl IntoZval for u32

const TYPE: DataType = DataType::Long

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl IntoZval for u64

const TYPE: DataType = DataType::Long

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl IntoZval for usize

const TYPE: DataType = DataType::Long

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl<'a, K, V, H> IntoZval for HashMap<K, V, H>

where K: Into<ArrayKey<'a>>, V: IntoZval, H: BuildHasher + Default,

const TYPE: DataType = DataType::Array

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl<'a, K, V, H> IntoZval for IndexMap<K, V, H>

where K: Into<ArrayKey<'a>>, V: IntoZval, H: BuildHasher + Default,

Available on crate feature indexmap only.

const TYPE: DataType = DataType::Array

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl<'a, K, V> IntoZval for BTreeMap<K, V>

where K: Into<ArrayKey<'a>>, V: IntoZval,

const TYPE: DataType = DataType::Array

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl<'a, K, V> IntoZval for Vec<(K, V)>

where K: Into<ArrayKey<'a>>, V: IntoZval,

const TYPE: DataType = DataType::Array

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl<M: SmartStringMode> IntoZval for SmartString<M>

Available on crate feature smartstring only.

const TYPE: DataType = DataType::String

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, persistent: bool) -> Result<()>

impl<T, E> IntoZval for Result<T, E>

where T: IntoZval, E: Into<PhpException>,

const TYPE: DataType = T::TYPE

const NULLABLE: bool = T::NULLABLE

fn set_zval(self, zv: &mut Zval, persistent: bool) -> Result<()>

impl<T> IntoZval for Option<T>

where T: IntoZval,

const TYPE: DataType = T::TYPE

const NULLABLE: bool = true

fn set_zval(self, zv: &mut Zval, persistent: bool) -> Result<()>

impl<T> IntoZval for Vec<T>

where T: IntoZval,

const TYPE: DataType = DataType::Array

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl<V, H> IntoZval for HashSet<V, H>

where V: IntoZval, H: BuildHasher,

const TYPE: DataType = DataType::Array

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl<V, H> IntoZval for IndexSet<V, H>

where V: IntoZval, H: BuildHasher,

Available on crate feature indexmap only.

const TYPE: DataType = DataType::Array

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

impl<V> IntoZval for BTreeSet<V>

where V: IntoZval,

const TYPE: DataType = DataType::Array

const NULLABLE: bool = false

fn set_zval(self, zv: &mut Zval, _: bool) -> Result<()>

Implementors

impl IntoZval for &mut ZendObject

const TYPE: DataType = DataType::ANY_OBJECT

const NULLABLE: bool = false

impl IntoZval for Closure

Available on crate feature closure only.

const TYPE: DataType

const NULLABLE: bool = false

impl IntoZval for ZBox<ZendHashTable>

const TYPE: DataType = DataType::Array

const NULLABLE: bool = false

impl IntoZval for ZBox<ZendObject>

const TYPE: DataType = DataType::ANY_OBJECT

const NULLABLE: bool = false

impl IntoZval for ZendEmptyArray

const TYPE: DataType = DataType::Array

const NULLABLE: bool = false

impl IntoZval for Zval

const TYPE: DataType = DataType::Mixed

const NULLABLE: bool = true

impl<T: Pack> IntoZval for Binary<T>

const TYPE: DataType = DataType::String

const NULLABLE: bool = false

impl<T: RegisteredClass> IntoZval for &mut ZendClassObject<T>

const TYPE: DataType

const NULLABLE: bool = false

impl<T: RegisteredClass> IntoZval for ZBox<ZendClassObject<T>>

const TYPE: DataType

const NULLABLE: bool = false

impl<T> IntoZval for T

where T: RegisteredEnum + RegisteredClass,

Available on crate feature enum only.

const TYPE: DataType

const NULLABLE: bool = false