Struct WStrBuf 

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

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

Examples

use imping_runtime::WStrBuf;

let mut name = WStrBuf::<4>::new();
name.set("Héllo");
assert_eq!(name.to_string_lossy(), "Hél"); // at most 3 code units, then the NUL

Implementations

impl<const N: usize> WStrBuf<N>

pub const fn new() -> Self

Creates an empty, all-zero buffer.

pub fn to_wide(&self) -> &[u16]

Returns the string’s UTF-16 code units: up to the first NUL, or the whole buffer if it has none.

pub fn to_string_lossy(&self) -> String

Returns the string as UTF-8, with unpaired surrogates replaced by �.

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

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

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

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

Returns the whole buffer.

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

Returns the whole buffer, to write to it directly.

pub fn as_ptr(&self) -> WStrPtr

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 WStrBuf<N>

fn clone(&self) -> WStrBuf<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 WStrBuf<N>

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

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

Formats the value using the given formatter.

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

fn default() -> Self

Returns an empty, all-zero buffer.

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

impl<const N: usize> Hash for WStrBuf<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 WStrBuf<N>

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

Equality operator ==.

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

Inequality operator !=.

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

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