Struct langtag::Variants

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

List of variant subtags.

Represents a list of variant subtags separated by a - character as found in a language tag.

Implementations

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

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

Parse and use the given data.

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

Use the given data as buffer without parsing it.

Safety

The given data must be syntactically correct.

impl Variants<[u8]>

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

Parse and borrow the given data.

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

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

Safety

The data must be syntactically correct.

impl Variants<Vec<u8>>

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

Parse and copy the input data.

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

Copy the input data without checking its syntax correctness.

Safety

The input data must be syntactically correct.

impl<T: AsRef<[u8]> + ?Sized> Variants<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.

impl Variants

pub fn empty() -> &'static Variants

Empty list (the empty string).

pub fn is_empty(&self) -> bool

Checks if the list is empty.

pub fn first(&self) -> Option<&Variant>

Returns the first subtag of the list (if any).

pub fn last(&self) -> Option<&Variant>

Returns the last subtag of the list (if any).

pub fn iter(&self) -> VariantsIter<'_>

Iterate through the subtags of the list.

pub fn contains<T: AsRef<[u8]> + ?Sized>(&self, subtag: &T) -> bool

Checks if the given subtag is included the list.

Trait Implementations

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

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

Performs the conversion.

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

pub fn as_ref(&self) -> &str

Performs the conversion.

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

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

Formats the value using the given formatter.

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

type Target = T

The resulting type after dereferencing.

pub fn deref(&self) -> &T

Dereferences the value.

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

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

Formats the value using the given formatter.

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

impl<T: AsRef<[u8]> + ?Sized> Hash for Variants<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<'a> IntoIterator for &'a Variants

type Item = &'a Variant

The type of the elements being iterated over.

type IntoIter = VariantsIter<'a>

Which kind of iterator are we turning this into?

pub fn into_iter(self) -> VariantsIter<'a>

Creates an iterator from a value.

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

pub fn cmp(&self, other: &Variants<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 Variants<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<Variants<T>> for [u8]

pub fn eq(&self, other: &Variants<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<Variants<T>> for str

pub fn eq(&self, other: &Variants<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<Variants<U>> for Variants<T>

pub fn eq(&self, other: &Variants<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 Variants<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<Variants<U>> for Variants<T>

pub fn partial_cmp(&self, other: &Variants<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 Variants<[u8]>

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.