Struct String 

pub struct String<const LEN: usize>(/* private fields */);

Represents a fixed-length byte string.

This type can be created from a &str or &[u8] if their byte length does not exceed the fixed length.

It can be freely converted from and to a [u8; N] array, and to a Vec<u8> where it will be cut at the first null byte.

It can be converted to a Rust String if it is UTF8 encoded.

Implementations

impl<const LEN: usize> String<LEN>

pub fn new() -> Self

Create a new empty string.

pub fn len(&self) -> usize

Return the number of bytes up to the first null byte.

pub fn is_empty(&self) -> bool

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

Get the slice up to the first null byte.

pub fn backing_array(&mut self) -> &mut [u8; LEN]

Get a reference to the full array of bytes.

Trait Implementations

impl<const LEN: usize> AsBytes for String<LEN>

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

Gets the bytes of this value.

fn as_bytes_mut(&mut self) -> &mut [u8]

where Self: FromBytes,

Gets the bytes of this value mutably.

fn write_to<B>(&self, bytes: B) -> Option<()>

where B: ByteSliceMut,

Writes a copy of self to bytes.

fn write_to_prefix<B>(&self, bytes: B) -> Option<()>

where B: ByteSliceMut,

Writes a copy of self to the prefix of bytes.

fn write_to_suffix<B>(&self, bytes: B) -> Option<()>

where B: ByteSliceMut,

Writes a copy of self to the suffix of bytes.

impl<const LEN: usize> Clone for String<LEN>

fn clone(&self) -> String<LEN>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<const LEN: usize> Copy for String<LEN>

impl<const LEN: usize> Debug for String<LEN>

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

Formats the value using the given formatter.

impl<const LEN: usize> Default for String<LEN>

fn default() -> Self

Returns the “default value” for a type.

impl<const LEN: usize> From<String<LEN>> for [u8; LEN]

fn from(bstr: String<LEN>) -> Self

Converts to this type from the input type.

impl<const LEN: usize> From<String<LEN>> for Vec<u8>

fn from(bstr: String<LEN>) -> Self

Converts to this type from the input type.

impl<const LEN: usize> From<[u8; LEN]> for String<LEN>

fn from(arr: [u8; LEN]) -> Self

Converts to this type from the input type.

impl<const LEN: usize> FromBytes for String<LEN>

fn read_from<B>(bytes: B) -> Option<Self>

where B: ByteSlice, Self: Sized,

Reads a copy of Self from bytes.

fn read_from_prefix<B>(bytes: B) -> Option<Self>

where B: ByteSlice, Self: Sized,

Reads a copy of Self from the prefix of bytes.

fn read_from_suffix<B>(bytes: B) -> Option<Self>

where B: ByteSlice, Self: Sized,

Reads a copy of Self from the suffix of bytes.

fn new_zeroed() -> Self

where Self: Sized,

Creates an instance of Self from zeroed bytes.

impl<const LEN: usize> PartialEq for String<LEN>

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

Equality operator ==.

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

Inequality operator !=.

impl<const LEN: usize> PartialEq<&[u8]> for String<LEN>

fn eq(&self, other: &&[u8]) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<const LEN: usize> PartialEq<&str> for String<LEN>

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

Equality operator ==.

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

Inequality operator !=.

impl<const LEN: usize> TryFrom<&[u8]> for String<LEN>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(arr: &[u8]) -> Result<Self, ()>

Performs the conversion.

impl<const LEN: usize> TryFrom<&str> for String<LEN>

type Error = ()

The type returned in the event of a conversion error.

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

Performs the conversion.

impl<const LEN: usize> TryFrom<String<LEN>> for String

type Error = Utf8Error

The type returned in the event of a conversion error.

fn try_from(bstr: String<LEN>) -> Result<Self, Self::Error>

Performs the conversion.