Struct FixedStr 

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

Stack-allocated, valid UTF-8 text with a fixed byte capacity.

Implementations

impl<const N: usize> FixedStr<N>

pub const fn new() -> Self

Creates an empty string.

pub const fn len(&self) -> usize

Returns the UTF-8 byte length.

pub const fn is_empty(&self) -> bool

Returns whether the string is empty.

pub const fn capacity(&self) -> usize

Returns the maximum UTF-8 byte capacity.

pub const fn remaining_capacity(&self) -> usize

Returns the remaining UTF-8 byte capacity.

pub fn as_str(&self) -> &str

Returns the contents as a string slice.

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

Returns the UTF-8 bytes.

pub fn clear(&mut self)

Removes all text.

pub fn try_push_str( &mut self, value: &str, ) -> Result<Range<usize>, CapacityError>

Appends text and returns its byte range.

pub fn push_str(&mut self, value: &str) -> Range<usize>

Appends text and returns its byte range.

Panics

Panics if the text exceeds the remaining capacity.

pub fn try_push(&mut self, value: char) -> Result<Range<usize>, CapacityError>

Appends one Unicode scalar and returns its UTF-8 byte range.

pub fn truncate(&mut self, new_len: usize)

Shortens the string to new_len UTF-8 bytes.

Panics

Panics unless new_len is a character boundary within the string.

pub const fn into_bytes(self) -> FixedBytes<N>

Converts the string into its fixed byte buffer.

Trait Implementations

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

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

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

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

Formats the value using the given formatter.

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

fn default() -> Self

Returns the “default value” for a type.

impl<const N: usize> Display for FixedStr<N>

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

Formats the value using the given formatter.

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

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

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

Equality operator ==.

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

Inequality operator !=.

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

impl<const N: usize> TryFrom<&str> for FixedStr<N>

type Error = CapacityError

The type returned in the event of a conversion error.

fn try_from(value: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl<const N: usize> TryFrom<FixedBytes<N>> for FixedStr<N>

type Error = Utf8Error

The type returned in the event of a conversion error.

fn try_from(value: FixedBytes<N>) -> Result<Self, Self::Error>

Performs the conversion.