Struct langtag::Extensions

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

List of extensions.

A list of language tag extension, separated by a - character. Individual extensions are represented by the Extension type, while extension subtags are represented by the ExtensionSubtag type.

Implementations

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

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

Parse and use the given data.

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

Use the given data as buffer without parsing it.

Safety

The given data must be syntactically correct.

impl Extensions<[u8]>

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

Parse and borrow the given data.

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

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

Safety

The data must be syntactically correct.

impl Extensions<Vec<u8>>

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

Parse and copy the input data.

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

Copy the input data without checking its syntax correctness.

Safety

The input data must be syntactically correct.

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

pub fn empty() -> &'static Extensions

The empty list of extension (an empty string).

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

Iterate extensions.

pub fn iter_subtags(&self) -> ExtensionsSubtagsIter<'_>

Iterate through each extensions subtags.

Eah subtag will be attached to its extension's singleton.

pub fn iter_extension(&self, e: Singleton) -> ExtensionSubtagsIter<'_>

Iterate through a specific extension subtags.

Trait Implementations

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

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

Performs the conversion.

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

pub fn as_ref(&self) -> &str

Performs the conversion.

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

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

Formats the value using the given formatter.

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

type Target = T

The resulting type after dereferencing.

pub fn deref(&self) -> &T

Dereferences the value.

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

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

Formats the value using the given formatter.

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

impl<T: AsRef<[u8]> + ?Sized> Hash for Extensions<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 Extensions

type IntoIter = ExtensionsIter<'a>

Which kind of iterator are we turning this into?

type Item = &'a Extension

The type of the elements being iterated over.

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

Creates an iterator from a value.

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

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

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

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

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

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.