Struct fixed_len_str_example::fixed_str12::FixedStr12

#[repr(transparent)]
pub struct FixedStr12 {
    pub array: [u8; 12],
}

A fixed length string with a length of 12.

Fields

array: [u8; 12]

Methods

impl FixedStr12

pub fn new(array: [u8; 12]) -> Result<Self, Utf8Error>

Creates an FixedStr12 from an array,returning an error at invalid utf8.

pub const unsafe fn new_unchecked(array: [u8; 12]) -> Self

Creates an FixedStr12 without checking if the bytes are valid utf8.

Safety

Ensure to only use this method with valid utf8.

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

Borrow the internal array as an slice.

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

Borrow the internal array as a mutable slice.

Safety

This is unsafe due to allow modifications that can produce invalid utf8.

pub fn fill_char(&mut self, character: char)

Fill the last spaces in zero of the buffer with a determinated character.Useful when constructing the array with all bytes in zero and then filling them in an incremental way.

Panics

This will panic on debug if the zero spaces are not sufficient for the non-zero spaces of the character interpreted as \[u8; 4\].

pub fn fill_str(&mut self, s: &str)

Fill the last spaces in zero of the buffer with a determinated string.Useful when constructing the array with all bytes in zero and then filling them in an incremental way.

Panics

This will panic on debug if the zero spaces are not sufficient for the non-zero spaces of the string interpreted as &\[u8\].

pub fn into_vec(self) -> Vec<u8>

Convert the FixedStr12 into a vector of bytes.

pub fn into_string(self) -> String

Turn the FixedStr12 into a string,moving the bytes.

pub fn from_vec(vec: Vec<u8>) -> FixedStr12

Construct a FixedStr12 from a vector of bytes,truncating or pushing zeroes to adjust the size to 12.

Using this function with multi-byte characters can easely produce an unexpected value.

pub fn from_string(string: String) -> FixedStr12

Construct a FixedStr12 from a String,truncating or pushing zeroes to adjust the size to 12.

Using this function with multi-byte characters can easely produce an unexpected value.

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

Construct a FixedStr12 from a str,without checking if it has length 12.

Safety

This will trigger UB on str's with length different than 12.

Trait Implementations

impl AsMut<str> for FixedStr12

fn as_mut(&mut self) -> &mut str

Performs the conversion.

impl AsRef<str> for FixedStr12

fn as_ref(&self) -> &str

Performs the conversion.

impl Borrow<str> for FixedStr12

fn borrow(&self) -> &str

Immutably borrows from an owned value.

impl BorrowMut<str> for FixedStr12

fn borrow_mut(&mut self) -> &mut str

Mutably borrows from an owned value.

impl Clone for FixedStr12

fn clone(&self) -> FixedStr12

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for FixedStr12

fn fmt(&self, f: &mut Formatter) -> FmtResult

Formats the value using the given formatter.

impl Default for FixedStr12

fn default() -> Self

Returns the "default value" for a type.

impl Deref for FixedStr12

type Target = str

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for FixedStr12

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'de> Deserialize<'de> for FixedStr12

Only expanded in the original crate with the feature "serde_support" enabled.

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for FixedStr12

fn fmt(&self, f: &mut Formatter) -> FmtResult

Formats the value using the given formatter.

impl Eq for FixedStr12

impl<'_> From<&'_ str> for FixedStr12

fn from(s: &str) -> Self

Construct a FixedStr12 from a str,if it is greater it take 12 bytes,if it is smaller it will leave the remanining spaces of the FixedStr12 in zero.

Panics

This will panic if the length of s is greater than 12 on debug.

impl From<[u8; 12]> for FixedStr12

fn from(a: [u8; 12]) -> Self

Performs the conversion.

impl From<String> for FixedStr12

fn from(s: String) -> Self

Performs the conversion.

impl From<Vec<u8>> for FixedStr12

fn from(v: Vec<u8>) -> Self

Performs the conversion.

impl Hash for FixedStr12

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, 

Feeds a slice of this type into the given [Hasher].

impl Index<Range<usize>> for FixedStr12

type Output = str

The returned type after indexing.

fn index(&self, index: Range<usize>) -> &str

Performs the indexing (container[index]) operation.

impl Index<RangeFrom<usize>> for FixedStr12

type Output = str

The returned type after indexing.

fn index(&self, index: RangeFrom<usize>) -> &str

Performs the indexing (container[index]) operation.

impl Index<RangeFull> for FixedStr12

type Output = str

The returned type after indexing.

fn index(&self, _index: RangeFull) -> &str

Performs the indexing (container[index]) operation.

impl Index<RangeInclusive<usize>> for FixedStr12

type Output = str

The returned type after indexing.

fn index(&self, index: RangeInclusive<usize>) -> &str

Performs the indexing (container[index]) operation.

impl Index<RangeTo<usize>> for FixedStr12

type Output = str

The returned type after indexing.

fn index(&self, index: RangeTo<usize>) -> &str

Performs the indexing (container[index]) operation.

impl Index<RangeToInclusive<usize>> for FixedStr12

type Output = str

The returned type after indexing.

fn index(&self, index: RangeToInclusive<usize>) -> &str

Performs the indexing (container[index]) operation.

impl IndexMut<Range<usize>> for FixedStr12

fn index_mut(&mut self, index: Range<usize>) -> &mut str

Performs the mutable indexing (container[index]) operation.

impl IndexMut<RangeFrom<usize>> for FixedStr12

fn index_mut(&mut self, index: RangeFrom<usize>) -> &mut str

Performs the mutable indexing (container[index]) operation.

impl IndexMut<RangeFull> for FixedStr12

fn index_mut(&mut self, _index: RangeFull) -> &mut str

Performs the mutable indexing (container[index]) operation.

impl IndexMut<RangeInclusive<usize>> for FixedStr12

fn index_mut(&mut self, index: RangeInclusive<usize>) -> &mut str

Performs the mutable indexing (container[index]) operation.

impl IndexMut<RangeTo<usize>> for FixedStr12

fn index_mut(&mut self, index: RangeTo<usize>) -> &mut str

Performs the mutable indexing (container[index]) operation.

impl IndexMut<RangeToInclusive<usize>> for FixedStr12

fn index_mut(&mut self, index: RangeToInclusive<usize>) -> &mut str

Performs the mutable indexing (container[index]) operation.

impl Ord for FixedStr12

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl<'_> PartialEq<&'_ str> for FixedStr12

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

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

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<FixedStr12> for FixedStr12

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

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

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<str> for FixedStr12

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

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

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialOrd<FixedStr12> for FixedStr12

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use] fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use] fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use] fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use] fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for FixedStr12

Only expanded in the original crate with the feature "serde_support" enabled.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.