Struct language_tags::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

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

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

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

pub fn canonicalize(&self) -> LanguageTag

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 Debug for LanguageTag

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

Formats the value using the given formatter.

impl Default for LanguageTag

fn default() -> LanguageTag

Returns the "default value" for a type.

impl Eq for LanguageTag

impl Clone for LanguageTag

fn clone(&self) -> LanguageTag

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialEq for LanguageTag

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

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

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

This method tests for !=.

impl FromStr for LanguageTag

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self>

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

impl Display for LanguageTag

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

Formats the value using the given formatter.