Z Str
A string is series of characters, where a character is the same as a byte.
Refer: https://www.php.net/manual/en/language.types.string.php
The &ZStr and ZString are
wrappers for zend_string.
ZStr can be converted to &[u8], &CStr and &str.
ZString can be constructed from impl AsRef<[u8]> and has pair of from_raw()
and into_raw(), like in [Box].
use phper::strings::ZString;
let s = ZString::new("Hello world!");
// Will leak memory.
let ptr = ZString::into_raw(s);
// retake pointer.
let ss = unsafe { ZString::from_raw(ptr) };
// `ZString` implements `PartialEq`.
assert_eq!(ss, "Hello world!");
ZString can be dereferenced to ZStr.
use phper::strings::ZString;
let s = ZString::new("Hello world!");
// `to_str` is the method of `ZStr`.
assert_eq!(s.to_str(), Ok("Hello world!"));
ZStr implements ToOwned. It can upgrade to ZString by value copying.
Because zend_string is reference counting type, so ZStr also implements
ToRefOwned (just like
RefClone for ZVal), can
upgrade to ZString by refcount increment.
use phper::sys;
use phper::strings::ZStr;
use phper::alloc::ToRefOwned;
unsafe extern "C" {
fn something() -> *mut sys::zend_string;
}
let s = unsafe { ZStr::from_mut_ptr(something()) };
// By value copying.
let _s = s.to_owned();
// By refcount increment.
let _s = s.to_ref_owned();
Note that neither ZStr nor ZString implements Send and Sync, because PHP
is single-threaded.