Struct LangTag 

pub struct LangTag(/* private fields */);

Any language tag (normal, private use or grandfathered).

Implementations

impl LangTag

pub const fn validate_str(input: &str) -> bool

pub const fn validate_bytes(input: &[u8]) -> bool

impl LangTag

pub fn new<T>(input: &T) -> Result<&LangTag, InvalidLangTag<&T>>

where T: AsRef<[u8]> + ?Sized,

Creates a new langtag by parsing the input value.

pub const fn from_bytes(input: &[u8]) -> Result<&LangTag, InvalidLangTag<&[u8]>>

Creates a new langtag by parsing the input bytes.

pub const fn from_str(input: &str) -> Result<&LangTag, InvalidLangTag<&str>>

Creates a new langtag by parsing the input string.

pub const unsafe fn new_unchecked_from_bytes(input: &[u8]) -> &LangTag

Creates a new langtag from the input bytes without validation.

Safety

The input bytes must be a valid langtag.

pub const unsafe fn new_unchecked(input: &str) -> &LangTag

Creates a new langtag from the input string without validation.

Safety

The input string must be a valid langtag.

impl LangTag

pub const fn as_str(&self) -> &str

Returns the langtag as a string.

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

Returns the langtag as a byte string.

impl LangTag

pub fn language(&self) -> Option<&Language>

Returns the language subtags, if any.

Only normal language tags and regular grandfathered tags have language subtags.

pub fn script(&self) -> Option<&Script>

Returns the script subtag, if any.

pub fn region(&self) -> Option<&Region>

Returns the region subtag, if any.

pub fn variants(&self) -> &Variants

Returns the variant subtags, if any.

pub fn extensions(&self) -> &Extensions

Returns the extension subtags, if any.

pub fn private_use(&self) -> Option<&PrivateUse>

Returns the private use subtag, if any.

pub fn private_use_subtags(&self) -> PrivateUseIter<'_>

Returns an iterator over the private use subtag subtags.

pub fn is_normal(&self) -> bool

Returns wether or not this language tag is a normal language tag.

pub fn is_private_use(&self) -> bool

Returns wether or not this language tag is a private use tag.

pub fn is_grandfathered(&self) -> bool

Returns wether or not this language tag is a grandfathered tag.

pub fn as_normal(&self) -> Option<&NormalLangTag>

Returns this language tag as a normal tag, if it is one.

pub fn as_private_use(&self) -> Option<&PrivateUse>

Returns this language tag as a private use tag, if it is one.

pub fn as_grandfathered(&self) -> Option<GrandfatheredLangTag>

Returns this language tag as a grandfathered tag, if it is one.

pub fn kind(&self) -> Kind

Returns the kind of the tag (normal, private use or grandfathered).

pub fn as_typed(&self) -> TypedLangTag<'_>

Find out what kind of language tag self is.

Trait Implementations

impl AsRef<LangTag> for LangTag

fn as_ref(&self) -> &LangTag

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<LangTag> for LangTagBuf

fn as_ref(&self) -> &LangTag

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<[u8]> for LangTag

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

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<str> for LangTag

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<LangTag> for LangTagBuf

fn borrow(&self) -> &LangTag

Immutably borrows from an owned value.

impl Borrow<str> for LangTag

fn borrow(&self) -> &str

Immutably borrows from an owned value.

impl Debug for LangTag

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

Formats the value using the given formatter.

impl Display for LangTag

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

Formats the value using the given formatter.

impl Eq for LangTag

impl Hash for LangTag

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

impl Ord for LangTag

fn cmp(&self, other: &LangTag) -> Ordering

This method returns an Ordering between self and other.

impl PartialEq for LangTag

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<&LangTag> for LangTagBuf

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<&[u8]> for LangTag

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<&str> for LangTag

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<LangTag> for LangTagBuf

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<LangTagBuf> for LangTag

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<LangTagBuf> for &LangTag

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<String> for LangTag

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<Vec<u8>> for LangTag

fn eq(&self, other: &Vec<u8>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<[u8]> for LangTag

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialEq<str> for LangTag

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for LangTag

fn partial_cmp(&self, other: &LangTag) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<&LangTag> for LangTagBuf

fn partial_cmp(&self, other: &&LangTag) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<&[u8]> for LangTag

fn partial_cmp(&self, other: &&[u8]) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<&str> for LangTag

fn partial_cmp(&self, other: &&str) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<LangTag> for LangTagBuf

fn partial_cmp(&self, other: &LangTag) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<LangTagBuf> for LangTag

fn partial_cmp(&self, other: &LangTagBuf) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<LangTagBuf> for &LangTag

fn partial_cmp(&self, other: &LangTagBuf) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<String> for LangTag

fn partial_cmp(&self, other: &String) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<Vec<u8>> for LangTag

fn partial_cmp(&self, other: &Vec<u8>) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<[u8]> for LangTag

fn partial_cmp(&self, other: &[u8]) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<str> for LangTag

fn partial_cmp(&self, other: &str) -> Option<Ordering>

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

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl RdfDisplay for LangTag

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

Formats the value using the given formatter.

fn rdf_display(&self) -> RdfDisplayed<&Self>

Prepare the value to be formatted as an RDF syntax element.

impl ToOwned for LangTag

type Owned = LangTagBuf

The resulting type after obtaining ownership.

fn to_owned(&self) -> <LangTag as ToOwned>::Owned

Creates owned data from borrowed data, usually by cloning.

fn clone_into(&self, target: &mut Self::Owned)

Uses borrowed data to replace owned data, usually by cloning.

impl<'a> TryFrom<&'a [u8]> for &'a LangTag

type Error = InvalidLangTag<&'a [u8]>

The type returned in the event of a conversion error.

fn try_from(value: &'a [u8]) -> Result<&'a LangTag, InvalidLangTag<&'a [u8]>>

Performs the conversion.

impl<'a> TryFrom<&'a str> for &'a LangTag

type Error = InvalidLangTag<&'a str>

The type returned in the event of a conversion error.

fn try_from(value: &'a str) -> Result<&'a LangTag, InvalidLangTag<&'a str>>

Performs the conversion.