Struct CStrBuf 

pub struct CStrBuf<const N: usize>(/* private fields */);

A fixed-size narrow string buffer inside a struct (char name[N]), holding a string up to the first NUL.

Examples

use imping_runtime::CStrBuf;

let mut tag = CStrBuf::<8>::new();
tag.set("Héllo, world");
assert_eq!(tag.to_string_lossy(), "Héllo,"); // at most 7 bytes, then the NUL

Implementations

impl<const N: usize> CStrBuf<N>

pub const fn new() -> Self

Creates an empty, all-zero buffer.

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

Returns the string’s bytes: up to the first NUL, or the whole buffer if it has none.

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

Returns the string as UTF-8.

Errors

If the bytes are not valid UTF-8.

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

Returns the string as UTF-8, with invalid sequences replaced by �.

pub fn to_string_ansi(&self) -> String

Decodes the string with the system’s ANSI code page.

On other platforms, the same as to_string_lossy.

pub fn set(&mut self, value: &str)

Stores value as UTF-8, truncated to fit before the terminating NUL.

Truncation never splits a character. A NUL in value ends it, and the rest of the buffer is zeroed.

pub fn as_array(&self) -> &[u8; N]

Returns the whole buffer.

pub fn as_array_mut(&mut self) -> &mut [u8; N]

Returns the whole buffer, to write to it directly.

pub fn as_ptr(&self) -> CStrPtr

Returns a pointer to the buffer, valid while it is alive and unmoved.

Reading through it needs a NUL within the buffer, which set guarantees.

Trait Implementations

impl<const N: usize> Clone for CStrBuf<N>

fn clone(&self) -> CStrBuf<N>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<const N: usize> Copy for CStrBuf<N>

impl<const N: usize> Debug for CStrBuf<N>

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

Formats the value using the given formatter.

impl<const N: usize> Default for CStrBuf<N>

fn default() -> Self

Returns an empty, all-zero buffer.

impl<const N: usize> Eq for CStrBuf<N>

impl<const N: usize> Hash for CStrBuf<N>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<const N: usize> PartialEq for CStrBuf<N>

fn eq(&self, other: &CStrBuf<N>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<const N: usize> Plain for CStrBuf<N>

impl<const N: usize> StructuralPartialEq for CStrBuf<N>