Struct tinystr::UnvalidatedTinyAsciiStr

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

A fixed-length bytes array that is expected to be an ASCII string but does not enforce that invariant.

Use this type instead of TinyAsciiStr if you don’t need to enforce ASCII during deserialization. For example, strings that are keys of a map don’t need to ever be reified as TinyAsciiStrs.

The main advantage of this type over [u8; N] is that it serializes as a string in human-readable formats like JSON.

Implementations

impl<const N: usize> UnvalidatedTinyAsciiStr<N>

pub fn try_into_tinystr(self) -> Result<TinyAsciiStr<N>, ParseError>

Converts into a TinyAsciiStr. Fails if the bytes are not valid ASCII.

pub const fn from_utf8_unchecked(bytes: [u8; N]) -> Self

Unsafely converts into a TinyAsciiStr.

Trait Implementations

impl<const N: usize> AsULE for UnvalidatedTinyAsciiStr<N>

type ULE = UnvalidatedTinyAsciiStr<N>

The ULE type corresponding to Self.

fn to_unaligned(self) -> Self::ULE

Converts from Self to Self::ULE.

fn from_unaligned(unaligned: Self::ULE) -> Self

Converts from Self::ULE to Self.

impl<const N: usize> Bake for UnvalidatedTinyAsciiStr<N>

fn bake(&self, env: &CrateEnv) -> TokenStream

Returns a TokenStream that would evaluate to self.

impl<const N: usize> BakeSize for UnvalidatedTinyAsciiStr<N>

fn borrows_size(&self) -> usize

Returns the size

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

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

Returns a copy of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<1>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<10>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<11>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<12>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<13>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<14>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<15>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<16>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<17>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<18>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<19>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<2>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<20>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<21>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<22>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<23>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<24>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<25>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<26>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<27>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<28>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<29>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<3>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<30>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<31>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<32>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<4>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<5>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<6>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<7>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<8>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, 'a> Deserialize<'de> for UnvalidatedTinyAsciiStr<9>

where 'de: 'a,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<const N: usize> From<TinyAsciiStr<N>> for UnvalidatedTinyAsciiStr<N>

fn from(other: TinyAsciiStr<N>) -> Self

Converts to this type from the input type.

impl<const N: usize> Ord for UnvalidatedTinyAsciiStr<N>

fn cmp(&self, other: &UnvalidatedTinyAsciiStr<N>) -> Ordering

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

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

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

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

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<const N: usize> PartialOrd for UnvalidatedTinyAsciiStr<N>

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl<const N: usize> Serialize for UnvalidatedTinyAsciiStr<N>

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<const N: usize> ULE for UnvalidatedTinyAsciiStr<N>

fn validate_bytes(bytes: &[u8]) -> Result<(), UleError>

Validates a byte slice, &[u8].

fn parse_bytes_to_slice(bytes: &[u8]) -> Result<&[Self], UleError>

Parses a byte slice, &[u8], and return it as &[Self] with the same lifetime.

unsafe fn slice_from_bytes_unchecked(bytes: &[u8]) -> &[Self]

Takes a byte slice, &[u8], and return it as &[Self] with the same lifetime, assuming that this byte slice has previously been run through [Self::parse_bytes_to_slice()] with success.

fn slice_as_bytes(slice: &[Self]) -> &[u8]

Given &[Self], returns a &[u8] with the same lifetime.

impl<'a, const N: usize> ZeroMapKV<'a> for UnvalidatedTinyAsciiStr<N>

type Container = ZeroVec<'a, UnvalidatedTinyAsciiStr<N>>

The container that can be used with this type: [ZeroVec] or [VarZeroVec].

type Slice = ZeroSlice<UnvalidatedTinyAsciiStr<N>>

type GetType = UnvalidatedTinyAsciiStr<N>

The type produced by Container::get()

type OwnedType = UnvalidatedTinyAsciiStr<N>

The type produced by Container::replace() and Container::remove(), also used during deserialization. If Self is human readable serialized, deserializing to Self::OwnedType should produce the same value once passed through Self::owned_as_self()

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

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

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