Struct arf_strings::PosixString

pub struct PosixString(_);

A utility for converting from inside-world path-oriented strings, such as file and directory names, into NUL-terminated byte strings that can be passed to POSIX-like APIs. Input strings containing NUL bytes are interpreted as ARF strings.

Implementations

impl PosixString

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

Construct a PosixString from data in the given byte slice, which should contain a valid UTF-8 string, which must either contain no NUL bytes, or must be a valid ARF string.

If the data is not valid UTF-8, or if it contains NUL bytes and is not valid ARF, return an error.

pub fn from_path_str(s: &str) -> Result<Self, ()>

Construct a PosixString from data in the given &str, which must either contain no NUL bytes, or must be a valid ARF string.

If the data contains NUL bytes and is not valid ARF, return an error.

pub fn as_cstr(&self) -> &CStr

Return a &CStr reference to the contained CString.

pub fn into_cstring(self) -> CString

Consume this PosixString and return the contained CString.