Struct ZString

pub struct ZString { /* private fields */ }

Like String, CString for zend_string.

Implementations

impl ZString

pub fn new(s: impl AsRef<[u8]>) -> Self

Creates a new zend string from a container of bytes.

pub fn new_persistent(s: impl AsRef<[u8]>) -> Self

Creates a new persistent zend string from a container of bytes.

pub unsafe fn from_raw(ptr: *mut zend_string) -> Self

Create owned object From raw pointer, usually used in pairs with into_raw.

Safety

This function is unsafe because improper use may lead to memory problems. For example, a double-free may occur if the function is called twice on the same raw pointer.

pub fn into_raw(self) -> *mut zend_string

Consumes the ZString and transfers ownership of the string to a raw pointer.

Methods from Deref<Target = ZStr>

pub fn as_ptr(&self) -> *const zend_string

Returns a raw pointer wrapped.

pub fn as_mut_ptr(&mut self) -> *mut zend_string

Returns a raw pointer wrapped.

pub fn as_c_str_ptr(&self) -> *const c_char

Converts to a raw C string pointer.

pub fn len(&self) -> usize

Gets the inner C string length.

pub fn is_empty(&self) -> bool

Returns true if self has a length of zero bytes.

pub fn to_bytes(&self) -> &[u8]

Converts inner C string to a byte slice.

pub fn to_c_str(&self) -> Result<&CStr, FromBytesWithNulError>

Extracts a CStr slice containing the inner C string.

pub fn to_str(&self) -> Result<&str, Utf8Error>

Yields a str slice if the ZStr contains valid UTF-8.

pub fn to_string_lossy(&self) -> Cow<'_, str>

Converts a slice of bytes to a string, including invalid characters.

Trait Implementations

impl AsRef<[u8]> for ZString

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<ZStr> for ZString

fn borrow(&self) -> &ZStr

Immutably borrows from an owned value.

impl Clone for ZString

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ZString

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

Formats the value using the given formatter.

impl Deref for ZString

type Target = ZStr

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for ZString

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Drop for ZString

fn drop(&mut self)

Executes the destructor for this type.

impl From<ZString> for ZVal

fn from(s: ZString) -> Self

Converts to this type from the input type.

impl<Rhs: AsRef<[u8]>> PartialEq<Rhs> for ZString

fn eq(&self, other: &Rhs) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.