[][src]Struct hyper::header::LanguageTag

pub struct LanguageTag {
    pub language: Option<String>,
    pub extlangs: Vec<String>,
    pub script: Option<String>,
    pub region: Option<String>,
    pub variants: Vec<String>,
    pub extensions: BTreeMap<u8, Vec<String>>,
    pub privateuse: Vec<String>,
}

A language tag as described in BCP47.

Language tags are used to help identify languages, whether spoken, written, signed, or otherwise signaled, for the purpose of communication. This includes constructed and artificial languages but excludes languages not intended primarily for human communication, such as programming languages.

Fields

language: Option<String>

Language subtags are used to indicate the language, ignoring all other aspects such as script, region or spefic invariants.

extlangs: Vec<String>

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.

script: Option<String>

Script subtags are used to indicate the script or writing system variations that distinguish the written forms of a language or its dialects.

region: Option<String>

Region subtags are used to indicate linguistic variations associated with or appropriate to a specific country, territory, or region. Typically, a region subtag is used to indicate variations such as regional dialects or usage, or region-specific spelling conventions. It can also be used to indicate that content is expressed in a way that is appropriate for use throughout a region, for instance, Spanish content tailored to be useful throughout Latin America.

variants: Vec<String>

Variant subtags are used to indicate additional, well-recognized variations that define a language or its dialects that are not covered by other available subtags.

extensions: BTreeMap<u8, Vec<String>>

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.

privateuse: Vec<String>

Private use subtags are used to indicate distinctions in language that are important in a given context by private agreement.

Methods

impl LanguageTag[src]

pub fn matches(&self, other: &LanguageTag) -> bool[src]

Matches language tags. The first language acts as a language range, the second one is used as a normal language tag. None fields in the language range are ignored. If the language tag has more extlangs than the range these extlangs are ignored. Matches are case-insensitive. * in language ranges are represented using None values. The language range * that matches language tags is created by the default language tag: let wildcard: LanguageTag = Default::default();.

For example the range en-GB matches only en-GB and en-Arab-GB but not en. The range en matches all language tags starting with en including en, en-GB, en-Arab and en-Arab-GB.

Panics

If the language range has extensions or private use tags.

Examples

let range_italian = langtag!(it);
let tag_german = langtag!(de);
let tag_italian_switzerland = langtag!(it;;;CH);
assert!(!range_italian.matches(&tag_german));
assert!(range_italian.matches(&tag_italian_switzerland));

let range_spanish_brazil = langtag!(es;;;BR);
let tag_spanish = langtag!(es);
assert!(!range_spanish_brazil.matches(&tag_spanish));

pub fn is_language_range(&self) -> bool[src]

Checks if it is a language range, meaning that there are no extension and privateuse tags.

pub fn canonicalize(&self) -> LanguageTag[src]

Returns the canonical version of the language tag.

It currently applies the following steps:

  • Grandfathered tags are replaced with the canonical version if possible.
  • Extension languages are promoted to primary language.
  • Deprecated languages are replaced with modern equivalents.
  • Deprecated regions are replaced with new country names.
  • The heploc variant is replaced with alalc97.

The returned language tags may not be completly canonical and they are not validated.

Trait Implementations

impl Clone for LanguageTag[src]

impl Debug for LanguageTag[src]

impl Default for LanguageTag[src]

impl Display for LanguageTag[src]

impl Eq for LanguageTag[src]

impl FromStr for LanguageTag[src]

type Err = Error

The associated error which can be returned from parsing.

impl PartialEq<LanguageTag> for LanguageTag[src]

impl StructuralEq for LanguageTag[src]

Auto Trait Implementations

impl RefUnwindSafe for LanguageTag

impl Send for LanguageTag

impl Sync for LanguageTag

impl Unpin for LanguageTag

impl UnwindSafe for LanguageTag

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T> ToString for T where
    T: Display + ?Sized
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.