Struct langtag::Variant

pub struct Variant<T: ?Sized = [u8]> { /* fields omitted */ }

Single variant subtag.

Variant subtags are used to indicate additional, well-recognized variations that define a language or its dialects that are not covered by other available subtags.

Implementations

impl<T: AsRef<[u8]>> Variant<T>

pub fn new(t: T) -> Result<Variant<T>, Error>

Parse and use the given data.

pub unsafe fn new_unchecked(t: T) -> Variant<T>

Use the given data as buffer without parsing it.

Safety

The given data must be syntactically correct.

impl Variant<[u8]>

pub fn parse<'a, T: AsRef<[u8]> + ?Sized>(
    bytes: &'a T
) -> Result<&'a Variant<[u8]>, Error>

Parse and borrow the given data.

pub unsafe fn parse_unchecked<'a, T: AsRef<[u8]> + ?Sized>(
    bytes: &'a T
) -> &'a Variant<[u8]>

Borrow the given data without checking that it is syntactically correct.

Safety

The data must be syntactically correct.

impl Variant<Vec<u8>>

pub fn parse_copy<'a, T: AsRef<[u8]> + ?Sized>(
    bytes: &'a T
) -> Result<Variant<Vec<u8>>, Error>

Parse and copy the input data.

pub unsafe fn parse_copy_unchecked<'a, T: AsRef<[u8]> + ?Sized>(
    bytes: &'a T
) -> Variant<Vec<u8>>

Copy the input data without checking its syntax correctness.

Safety

The input data must be syntactically correct.

impl<T: AsRef<[u8]> + ?Sized> Variant<T>

pub fn len(&self) -> usize

Bytes length.

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

Return a reference to the underlying data.

pub fn as_str(&self) -> &str

Return a reference to the underlying data as a string.

Trait Implementations

impl<T: AsRef<[u8]> + ?Sized> AsRef<[u8]> for Variant<T>

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

Performs the conversion.

impl<T: AsRef<[u8]> + ?Sized> AsRef<str> for Variant<T>

pub fn as_ref(&self) -> &str

Performs the conversion.

impl<T: AsRef<[u8]> + ?Sized> Debug for Variant<T>

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

Formats the value using the given formatter.

impl<T: ?Sized> Deref for Variant<T>

type Target = T

The resulting type after dereferencing.

pub fn deref(&self) -> &T

Dereferences the value.

impl<T: AsRef<[u8]> + ?Sized> Display for Variant<T>

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

Formats the value using the given formatter.

impl<T: AsRef<[u8]> + ?Sized> Eq for Variant<T>

impl<T: AsRef<[u8]> + ?Sized> Hash for Variant<T>

pub fn hash<H: Hasher>(&self, h: &mut H)

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl<T: AsRef<[u8]> + ?Sized> Ord for Variant<T>

pub fn cmp(&self, other: &Variant<T>) -> Ordering

This method returns an Ordering between self and other.

#[must_use]pub fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]pub fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]pub fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl<T: AsRef<[u8]> + ?Sized> PartialEq<[u8]> for Variant<T>

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

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

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

This method tests for !=.

impl<T: AsRef<[u8]> + ?Sized> PartialEq<Variant<T>> for [u8]

pub fn eq(&self, other: &Variant<T>) -> bool

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

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

This method tests for !=.

impl<T: AsRef<[u8]> + ?Sized> PartialEq<Variant<T>> for str

pub fn eq(&self, other: &Variant<T>) -> bool

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

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

This method tests for !=.

impl<T: AsRef<[u8]> + ?Sized, U: AsRef<[u8]> + ?Sized> PartialEq<Variant<U>> for Variant<T>

pub fn eq(&self, other: &Variant<U>) -> bool

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

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

This method tests for !=.

impl<T: AsRef<[u8]> + ?Sized> PartialEq<str> for Variant<T>

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

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

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

This method tests for !=.

impl<T: AsRef<[u8]> + ?Sized, U: AsRef<[u8]> + ?Sized> PartialOrd<Variant<U>> for Variant<T>

pub fn partial_cmp(&self, other: &Variant<U>) -> Option<Ordering>

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

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

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

#[must_use]pub 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]pub fn gt(&self, other: &Rhs) -> bool

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

#[must_use]pub 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<'a> TryFrom<&'a [u8]> for &'a Variant<[u8]>

type Error = Error

The type returned in the event of a conversion error.

pub fn try_from(b: &'a [u8]) -> Result<&'a Variant<[u8]>, Error>

Performs the conversion.

impl<'a> TryFrom<&'a str> for &'a Variant<[u8]>

type Error = Error

The type returned in the event of a conversion error.

pub fn try_from(b: &'a str) -> Result<&'a Variant<[u8]>, Error>

Performs the conversion.