Struct langtag::LanguageExtension

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

List of extended language subtags.

This type represents a list of extended language subtags, separated by a - character.

Extended language subtags are used to identify certain specially selected languages that, for various historical and compatibility reasons, are closely identified with or tagged using an existing primary language subtag. The type ExtendedLangTag represents a single extended language subtag.

Implementations

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

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

Parse and use the given data.

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

Use the given data as buffer without parsing it.

Safety

The given data must be syntactically correct.

impl LanguageExtension<[u8]>

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

Parse and borrow the given data.

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

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

Safety

The data must be syntactically correct.

impl LanguageExtension<Vec<u8>>

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

Parse and copy the input data.

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

Copy the input data without checking its syntax correctness.

Safety

The input data must be syntactically correct.

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

pub fn empty() -> &'static LanguageExtension

Empty list (the empty string).

pub fn is_empty(&self) -> bool

Checks if the list is empty.

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

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

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

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

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

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 LanguageExtension<T>

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

Performs the conversion.

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

pub fn as_ref(&self) -> &str

Performs the conversion.

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

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

Formats the value using the given formatter.

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

type Target = T

The resulting type after dereferencing.

pub fn deref(&self) -> &T

Dereferences the value.

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

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

Formats the value using the given formatter.

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

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

type Item = &'a ExtendedLangTag

The type of the elements being iterated over.

type IntoIter = LanguageExtensionIter<'a>

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

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

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

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

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

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.