Struct tiny_std::UnixStr

#[repr(transparent)]
pub struct UnixStr(_);

Implementations

impl UnixStr

pub const unsafe fn from_str_unchecked(s: &str) -> &UnixStr

Safety

&str needs to be null terminated or downstream UB may occur

pub const fn from_str_checked(s: &str) -> &UnixStr

Const instantiation of a &UnixStr from a &str. Should only be used in a const-context, although rustc does not let me enforce this.

Panics

This method panics since it’s supposed to produce a comptime error, it’s not particularly efficient.

pub unsafe fn from_ptr<'a>(s: *const u8) -> &'a UnixStr

Safety

s needs to be null terminated

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

Try to convert this &UnixStr to a utf8 &str

Errors

Not utf8

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

Get this &UnixStr as a slice, including the null byte

pub fn len(&self) -> usize

Get the length of this &UnixStr, including the null byte

Trait Implementations

impl AsUnixStr for &UnixStr

fn exec_with_self_as_ptr<F, T>(&self, func: F) -> Result<T, Error>where F: FnOnce(*const u8) -> Result<T, Error>,

Executes a function with this null terminated entity converts it to a string and pushes a null byte if not already null terminated

unsafe fn match_up_to(&self, null_terminated_pointer: *const u8) -> usize

Checks if this AsUnixStr matches a null terminated pointer and returns the non null length

impl AsUnixStr for &mut UnixStr

fn exec_with_self_as_ptr<F, T>(&self, func: F) -> Result<T, Error>where F: FnOnce(*const u8) -> Result<T, Error>,

Executes a function with this null terminated entity converts it to a string and pushes a null byte if not already null terminated

unsafe fn match_up_to(&self, null_terminated_pointer: *const u8) -> usize

Checks if this AsUnixStr matches a null terminated pointer and returns the non null length

impl Debug for UnixStr

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

Formats the value using the given formatter.

impl From<&UnixStr> for UnixString

fn from(s: &UnixStr) -> UnixString

Converts to this type from the input type.

impl PartialEq<UnixStr> for UnixStr

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl ToUnixString for &UnixStr

fn to_unix_string(&self) -> Result<UnixString, Error>

Turn this into a UnixString

impl ToUnixString for &mut UnixStr

fn to_unix_string(&self) -> Result<UnixString, Error>

Turn this into a UnixString

impl Eq for UnixStr

impl StructuralEq for UnixStr

impl StructuralPartialEq for UnixStr