Struct oxilangtag::LanguageTag

pub struct LanguageTag<T> { /* fields omitted */ }

A RFC 5646 language tag.

use oxilangtag::LanguageTag;

let language_tag = LanguageTag::parse("en-us").unwrap();
assert_eq!("en-us", language_tag.into_inner())

Implementations

impl<T: Deref<Target = str>> LanguageTag<T>

pub fn parse(tag: T) -> Result<Self, LanguageTagParseError>

Parses a language tag acccording to RFC 5646. and checks if the tag is "well-formed".

This operation keeps internally the tag parameter and does not allocate on the heap.

use oxilangtag::LanguageTag;

let language_tag = LanguageTag::parse("en-us").unwrap();
assert_eq!("en-us", language_tag.into_inner())

pub fn as_str(&self) -> &str

Returns the underlying language tag representation.

pub fn into_inner(self) -> T

Returns the underlying language tag representation.

pub fn primary_language(&self) -> &str

Returns the primary language subtag.

pub fn extended_language(&self) -> Option<&str>

Returns the extended language subtags.

Valid language tags have at most one extended language.

pub fn extended_language_subtags(&self) -> impl Iterator<Item = &str>

Iterates on the extended language subtags.

Valid language tags have at most one extended language.

pub fn full_language(&self) -> &str

Returns the primary language subtag and its extended language subtags.

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

Returns the script subtag.

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

Returns the region subtag.

pub fn variant(&self) -> Option<&str>

Returns the variant subtags.

pub fn variant_subtags(&self) -> impl Iterator<Item = &str>

Iterates on the variant subtags.

pub fn extension(&self) -> Option<&str>

Returns the extension subtags.

pub fn extension_subtags(&self) -> impl Iterator<Item = (char, &str)>

Iterates on the extension subtags.

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

Returns the private use subtags.

pub fn private_use_subtags(&self) -> impl Iterator<Item = &str>

Iterates on the private use subtags.

impl LanguageTag<String>

pub fn parse_and_normalize(tag: &str) -> Result<Self, LanguageTagParseError>

Parses a language tag acccording to RFC 5646 and normalizes its case.

This parser accepts the language tags that are "well-formed" according to RFC 5646.

This operation does heap allocation.

use oxilangtag::LanguageTag;

let language_tag = LanguageTag::parse_and_normalize("en-us").unwrap();
assert_eq!("en-US", language_tag.into_inner())

Trait Implementations

impl<T: AsRef<str>> AsRef<str> for LanguageTag<T>

fn as_ref(&self) -> &str

Performs the conversion.

impl<T: Borrow<str>> Borrow<str> for LanguageTag<T>

fn borrow(&self) -> &str

Immutably borrows from an owned value.

impl<T: Clone> Clone for LanguageTag<T>

fn clone(&self) -> LanguageTag<T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Copy> Copy for LanguageTag<T>

impl<T: Debug> Debug for LanguageTag<T>

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<T: Deref<Target = str>> Deref for LanguageTag<T>

type Target = str

The resulting type after dereferencing.

fn deref(&self) -> &str

Dereferences the value.

impl<T: Display> Display for LanguageTag<T>

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<T: Eq> Eq for LanguageTag<T>

impl<'a> From<LanguageTag<&'a str>> for LanguageTag<String>

fn from(tag: LanguageTag<&'a str>) -> Self

Performs the conversion.

impl<'a> From<LanguageTag<&'a str>> for LanguageTag<Cow<'a, str>>

fn from(tag: LanguageTag<&'a str>) -> Self

Performs the conversion.

impl From<LanguageTag<Box<str>>> for LanguageTag<String>

fn from(tag: LanguageTag<Box<str>>) -> Self

Performs the conversion.

impl<'a> From<LanguageTag<Cow<'a, str>>> for LanguageTag<String>

fn from(tag: LanguageTag<Cow<'a, str>>) -> Self

Performs the conversion.

impl<'a> From<LanguageTag<String>> for LanguageTag<Cow<'a, str>>

fn from(tag: LanguageTag<String>) -> Self

Performs the conversion.

impl FromStr for LanguageTag<String>

type Err = LanguageTagParseError

The associated error which can be returned from parsing.

fn from_str(tag: &str) -> Result<Self, LanguageTagParseError>

Parses a string s to return a value of this type.

impl<T: Hash> Hash for LanguageTag<T>

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

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl<T: Ord> Ord for LanguageTag<T>

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

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl<'a, T: PartialEq<&'a str>> PartialEq<&'a str> for LanguageTag<T>

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'a, T: PartialEq<Cow<'a, str>>> PartialEq<Cow<'a, str>> for LanguageTag<T>

fn eq(&self, other: &Cow<'a, str>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<Lft: PartialEq<Rhs>, Rhs> PartialEq<LanguageTag<Rhs>> for LanguageTag<Lft>

fn eq(&self, other: &LanguageTag<Rhs>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: PartialEq<str>> PartialEq<LanguageTag<T>> for str

fn eq(&self, other: &LanguageTag<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'a, T: PartialEq<&'a str>> PartialEq<LanguageTag<T>> for &'a str

fn eq(&self, other: &LanguageTag<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: PartialEq<String>> PartialEq<LanguageTag<T>> for String

fn eq(&self, other: &LanguageTag<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'a, T: PartialEq<Cow<'a, str>>> PartialEq<LanguageTag<T>> for Cow<'a, str>

fn eq(&self, other: &LanguageTag<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: PartialEq<String>> PartialEq<String> for LanguageTag<T>

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: PartialEq<str>> PartialEq<str> for LanguageTag<T>

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: PartialOrd> PartialOrd<LanguageTag<T>> for LanguageTag<T>

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

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

#[must_use]fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]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]fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]fn ge(&self, other: &Rhs) -> bool

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