Struct swim_c::cstr::CStr

pub struct CStr { /* fields omitted */ }

A nul-terminated sequence of C chars.

Methods

impl CStr

pub fn from_ptr<'a>(ptr: *const u8) -> &'a Self

Converts a pointer to a nul-terminated byte array to a CStr.

pub fn from_cptr<'a>(ptr: *const cchar) -> &'a Self

Converts a pointer to a nul-terminated C char array to a CStr.

pub fn from_bytes(bytes: &[u8]) -> Result<&Self, ()>

Converts a byte slice to a CStr, if the slice ends with a nul byte.

pub unsafe fn from_bytes_unchecked(bytes: &[u8]) -> &Self

Converts a byte slice to a CStr, without verifying that the slice ends with a nul byte.

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

Converts this string to a pointer to a nul-terminated byte array.

pub fn as_cptr(&self) -> *const cchar

Converts this string to a pointer to a nul-terminated C char array.

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

Returns a byte slice containing the string and trailing nul byte.

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

Returns a string slice containing the string with no trailing nul byte.

pub unsafe fn to_str_unchecked(&self) -> &str

Returns a string slice containing the string with no trailing nul byte, without verifying that the string contains valid UTF-8.

Trait Implementations

impl Debug for CStr

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

Formats the value using the given formatter.

impl AsRef<CStr> for CStr

fn as_ref(&self) -> &CStr

Performs the conversion.

impl Default for &'static CStr

fn default() -> &'static CStr

Returns the "default value" for a type.

impl<L: Lease<Data = u8, Meta = BufHeader<M>>, M> ResidentAsRef<L, CStr> for CString<M>

fn resident_as_ref(lease: &L) -> &CStr

Returns the resident of the lease as an immutable reference to type T.

impl<L: Lease<Data = u8, Meta = BufHeader<M>>, M> ResidentFromCopyUnchecked<L, CStr, M> for CString<M>

fn new_resident_layout(data: &CStr, meta: &M) -> Layout

Returns the memory layout for a resident with a copy of the given data and meta data.

fn new_resident_ptr(raw: *mut u8, data: &CStr, meta: &M) -> *mut u8

Converts a raw pointer into a Data pointer for a resident with a copy of the given data and meta data.

fn new_resident(lease: &mut L, data: &CStr, meta: M)

Initializes the lease with a resident from a copy of the given data and meta data.