Struct langtag::Extension

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

Single extension and its subtags.

Extensions provide a mechanism for extending language tags for use in various applications. They are intended to identify information that is commonly used in association with languages or language tags but that is not part of language identification.

An extension is composed of a singleton (a single character) followed by associated subtags. For instance a-subtag1-subtag2. Each subtag of the extension is represented by the ExtensionSubtag type.

Implementations

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

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

Parse and use the given data.

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

Use the given data as buffer without parsing it.

Safety

The given data must be syntactically correct.

impl Extension<[u8]>

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

Parse and borrow the given data.

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

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

Safety

The data must be syntactically correct.

impl Extension<Vec<u8>>

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

Parse and copy the input data.

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

Copy the input data without checking its syntax correctness.

Safety

The input data must be syntactically correct.

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

pub fn empty() -> &'static Extension

Empty list (the empty string).

pub fn is_empty(&self) -> bool

Checks if the list is empty.

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

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

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

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

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

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.

impl Extension

pub fn singleton(&self) -> u8

Return the singletong identifying the extension.

Trait Implementations

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

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

Performs the conversion.

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

pub fn as_ref(&self) -> &str

Performs the conversion.

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

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

Formats the value using the given formatter.

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

type Target = T

The resulting type after dereferencing.

pub fn deref(&self) -> &T

Dereferences the value.

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

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

Formats the value using the given formatter.

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

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

type Item = &'a ExtensionSubtag

The type of the elements being iterated over.

type IntoIter = ExtensionIter<'a>

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

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

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

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

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

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.