Struct AliasesV1

pub struct AliasesV1<'data> {
    pub language_variants: VarZeroVec<'data, StrStrPairVarULE>,
    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, StrStrPairVarULE>

[language(-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 AliasesV1<'data>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'data> Debug for AliasesV1<'data>

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

Formats the value using the given formatter.

impl<'data> Default for AliasesV1<'data>

fn default() -> AliasesV1<'data>

Returns the “default value” for a type.

impl<'data> PartialEq for AliasesV1<'data>

fn eq(&self, other: &AliasesV1<'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<'data> TryFrom<AliasesV1<'data>> for AliasesV2<'data>

type Error = DataError

The type returned in the event of a conversion error.

fn try_from(value: AliasesV1<'data>) -> Result<Self, Self::Error>

Performs the conversion.

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

type Output = AliasesV1<'a>

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

fn transform(&'a self) -> &'a Self::Output

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

fn transform_owned(self) -> Self::Output

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

unsafe fn make(this: Self::Output) -> Self

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 Self::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, AliasesV1<'zf_inner>> for AliasesV1<'zf>

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

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

impl<'data> StructuralPartialEq for AliasesV1<'data>