Struct Aliases

pub struct Aliases<'data> {
    pub language_variants: VarZeroVec<'data, LanguageStrStrPairVarULE>,
    pub sgn_region: ZeroMap<'data, UnvalidatedTinyAsciiStr<3>, Language>,
    pub language_len2: ZeroMap<'data, UnvalidatedTinyAsciiStr<2>, str>,
    pub language_len3: ZeroMap<'data, UnvalidatedTinyAsciiStr<3>, str>,
    pub language: VarZeroVec<'data, StrStrPairVarULE>,
    pub script: ZeroMap<'data, UnvalidatedTinyAsciiStr<4>, Script>,
    pub region_alpha: ZeroMap<'data, UnvalidatedTinyAsciiStr<2>, Region>,
    pub region_num: ZeroMap<'data, UnvalidatedTinyAsciiStr<3>, Region>,
    pub complex_region: ZeroMap<'data, UnvalidatedTinyAsciiStr<3>, ZeroSlice<Region>>,
    pub variant: ZeroMap<'data, UnvalidatedTinyAsciiStr<8>, Variant>,
    pub subdivision: ZeroMap<'data, UnvalidatedTinyAsciiStr<7>, TinyAsciiStr<7>>,
}

This alias data is used for locale canonicalization.

Each field defines a mapping from an old identifier to a new identifier, based upon the rules in from http://unicode.org/reports/tr35/#LocaleId_Canonicalization. The data is stored in sorted order, allowing for binary search to identify rules to apply. It is broken down into smaller vectors based upon some characteristic of the data, to help avoid unnecessary searches. For example, the sgn_region field contains aliases for sign language and region, so that it is not necessary to search the data unless the input is a sign language.

The algorithm in tr35 is not guaranteed to terminate on data other than what is currently in CLDR. For this reason, it is not a good idea to attempt to add or modify aliases for use in this structure.

🚧 This code is considered unstable; it may change at any time, in breaking or non-breaking ways, including in SemVer minor releases. While the serde representation of data structs is guaranteed to be stable, their Rust representation might not be. Use with caution.

Fields

language_variants: VarZeroVec<'data, LanguageStrStrPairVarULE>

[language, variant(-variant)*] -> [langid] This is not a map as it’s searched linearly according to the canonicalization rules.

sgn_region: ZeroMap<'data, UnvalidatedTinyAsciiStr<3>, Language>

sgn-[region] -> [language]

language_len2: ZeroMap<'data, UnvalidatedTinyAsciiStr<2>, str>

[language{2}] -> [langid]

language_len3: ZeroMap<'data, UnvalidatedTinyAsciiStr<3>, str>

[language{3}] -> [langid]

language: VarZeroVec<'data, StrStrPairVarULE>

[langid] -> [langid] This is not a map as it’s searched linearly according to the canonicalization rules.

script: ZeroMap<'data, UnvalidatedTinyAsciiStr<4>, Script>

[script] -> [script]

region_alpha: ZeroMap<'data, UnvalidatedTinyAsciiStr<2>, Region>

[region{2}] -> [region]

region_num: ZeroMap<'data, UnvalidatedTinyAsciiStr<3>, Region>

[region{3}] -> [region]

complex_region: ZeroMap<'data, UnvalidatedTinyAsciiStr<3>, ZeroSlice<Region>>

[region] -> [region]+

variant: ZeroMap<'data, UnvalidatedTinyAsciiStr<8>, Variant>

[variant] -> [variant]

subdivision: ZeroMap<'data, UnvalidatedTinyAsciiStr<7>, TinyAsciiStr<7>>

[value{7}] -> [value{7}]

Trait Implementations

impl<'data> Clone for Aliases<'data>

fn clone(&self) -> Aliases<'data>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'data> Debug for Aliases<'data>

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

Formats the value using the given formatter.

impl<'data> Default for Aliases<'data>

fn default() -> Aliases<'data>

Returns the “default value” for a type.

impl<'de, 'data> Deserialize<'de> for Aliases<'data>

where 'de: 'data,

fn deserialize<__D>( __deserializer: __D, ) -> Result<Aliases<'data>, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl MaybeAsVarULE for Aliases<'_>

type EncodedStruct = [()]

The VarULE type for this data struct, or [()] if it cannot be represented as VarULE.

impl<'data> PartialEq for Aliases<'data>

fn eq(&self, other: &Aliases<'data>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Yokeable<'a> for Aliases<'static>

type Output = Aliases<'a>

This type MUST be Self with the 'static replaced with 'a, i.e. Self<'a>

fn transform(&'a self) -> &'a <Aliases<'static> as Yokeable<'a>>::Output

This method must cast self between &'a Self<'static> and &'a Self<'a>.

fn transform_owned(self) -> <Aliases<'static> as Yokeable<'a>>::Output

This method must cast self between Self<'static> and Self<'a>.

unsafe fn make( this: <Aliases<'static> as Yokeable<'a>>::Output, ) -> Aliases<'static>

This method can be used to cast away Self<'a>’s lifetime.

fn transform_mut<F>(&'a mut self, f: F)

where F: 'static + for<'b> FnOnce(&'b mut <Aliases<'static> as Yokeable<'a>>::Output),

This method must cast self between &'a mut Self<'static> and &'a mut Self<'a>, and pass it to f.

impl<'zf, 'zf_inner> ZeroFrom<'zf, Aliases<'zf_inner>> for Aliases<'zf>

fn zero_from(this: &'zf Aliases<'zf_inner>) -> Aliases<'zf>

Clone the other C into a struct that may retain references into C.

impl<'data> StructuralPartialEq for Aliases<'data>