Struct unic_locale_impl::extensions::TransformExtensionList

pub struct TransformExtensionList { /* fields omitted */ }

A list of Unicode BCP47 T Extensions as defined in Unicode Locale Identifier specification.

Transform extension carries information about source language or script of transformed content, including content that has been transliterated, transcribed, or translated, or in some other way influenced by the source (See RFC 6497 for details).

Examples

use unic_locale_impl::{Locale, LanguageIdentifier};

let mut loc: Locale = "de-t-en-US-h0-hybrid".parse()
    .expect("Parsing failed.");

let en_us: LanguageIdentifier = "en-US".parse()
    .expect("Parsing failed.");

assert_eq!(loc.extensions.transform.tlang(), Some(&en_us));
assert_eq!(
    loc.extensions.transform.tfield("h0")
                            .expect("Getting tfield failed.")
                            .collect::<Vec<_>>(),
    &["hybrid"]
);

Methods

impl TransformExtensionList

pub fn is_empty(&self) -> bool

Returns true if there are no tfields and no tlang in the TransformExtensionList.

Examples

use unic_locale_impl::Locale;

let mut loc: Locale = "en-US-t-es-AR".parse()
    .expect("Parsing failed.");

assert_eq!(loc.extensions.transform.is_empty(), false);

pub fn tlang(&self) -> Option<&LanguageIdentifier>

Gets tlang from the TransformExtensionList.

Examples

use unic_locale_impl::Locale;
use unic_langid_impl::LanguageIdentifier;

let mut loc: Locale = "en-US-t-es-AR".parse()
    .expect("Parsing failed.");

let tlang: LanguageIdentifier = "es-AR".parse()
    .expect("Parsing failed on tlang.");

assert_eq!(loc.extensions.transform.tlang(), Some(&tlang));

pub fn set_tlang(
    &mut self,
    tlang: LanguageIdentifier
) -> Result<(), LocaleError>

Sets tlang on the TransformExtensionList.

Examples

use unic_locale_impl::Locale;
use unic_langid_impl::LanguageIdentifier;

let mut loc: Locale = "en-US".parse()
    .expect("Parsing failed.");

let tlang: LanguageIdentifier = "es-AR".parse()
    .expect("Parsing failed on tlang.");

loc.extensions.transform.set_tlang(tlang)
    .expect("Setting tlang failed.");

assert_eq!(loc.to_string(), "en-US-t-es-AR");

pub fn clear_tlang(&mut self)

Clears tlang on the TransformExtensionList.

Examples

use unic_locale_impl::Locale;
use unic_langid_impl::LanguageIdentifier;

let mut loc: Locale = "en-US-t-es-AR".parse()
    .expect("Parsing failed.");

loc.extensions.transform.clear_tlang();

assert_eq!(loc.to_string(), "en-US");

pub fn tfield<S: AsRef<[u8]>>(
    &self,
    tkey: S
) -> Result<impl ExactSizeIterator<Item = &str>, LocaleError>

Returns the tvalue of tfield in the TransformExtensionList.

Examples

use unic_locale_impl::Locale;

let mut loc: Locale = "en-US-t-k0-dvorak".parse()
    .expect("Parsing failed.");

assert_eq!(loc.extensions.transform.tfield("k0")
               .expect("Getting tfield failed.")
               .collect::<Vec<_>>(),
           &["dvorak"]);

// Here tfield with tkey "m0" is not available
assert_eq!(loc.extensions.transform.tfield("m0")
               .expect("Getting tfield failed.")
               .collect::<Vec<_>>()
               .is_empty(),
           true);

pub fn tfield_keys(&self) -> impl ExactSizeIterator<Item = &str>

Returns an iterator over all tkeys in the TransformExtensionList.

Examples

use unic_locale_impl::Locale;

let mut loc: Locale = "en-US-t-k0-dvorak-h0-hybrid".parse()
    .expect("Parsing failed.");

assert_eq!(loc.extensions.transform.tfield_keys().collect::<Vec<_>>(),
           &["h0", "k0"]);

pub fn set_tfield<S: AsRef<[u8]>>(
    &mut self,
    tkey: S,
    tvalue: &[S]
) -> Result<(), LocaleError>

Adds a tfield to the TransformExtensionList or sets tvalue for tkey if tfield is already included in the TransformExtensionList.

Examples

use unic_locale_impl::Locale;

let mut loc: Locale = "en-US".parse()
    .expect("Parsing failed.");

loc.extensions.transform.set_tfield("k0", &["dvorak"])
    .expect("Setting tfield failed.");

assert_eq!(loc.to_string(), "en-US-t-k0-dvorak");

loc.extensions.transform.set_tfield("k0", &["colemak"])
    .expect("Setting tfield failed.");

assert_eq!(loc.to_string(), "en-US-t-k0-colemak");

pub fn remove_tfield<S: AsRef<[u8]>>(
    &mut self,
    tkey: S
) -> Result<bool, LocaleError>

Removes a tfield from the TransformExtensionList.

Returns true if tfield was included in the TransformExtensionList before removal.

Examples

use unic_locale_impl::Locale;

let mut loc: Locale = "en-US-t-k0-dvorak".parse()
    .expect("Parsing failed.");

assert_eq!(loc.extensions.transform.remove_tfield("k0")
               .expect("Removing tfield failed."),
           true);

assert_eq!(loc.to_string(), "en-US");

pub fn clear_tfields(&mut self)

Clears all tfields from the TransformExtensionList.

Examples

use unic_locale_impl::Locale;

let mut loc: Locale = "en-US-t-k0-dvorak".parse()
    .expect("Parsing failed.");

loc.extensions.transform.clear_tfields();
assert_eq!(loc.to_string(), "en-US");

Trait Implementations

impl Clone for TransformExtensionList

fn clone(&self) -> TransformExtensionList

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TransformExtensionList

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

Formats the value using the given formatter.

impl Default for TransformExtensionList

fn default() -> TransformExtensionList

Returns the "default value" for a type.

impl Display for TransformExtensionList

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

Formats the value using the given formatter.

impl Eq for TransformExtensionList

impl Hash for TransformExtensionList

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 Ord for TransformExtensionList

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

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

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

Restrict a value to a certain interval.

impl PartialEq<TransformExtensionList> for TransformExtensionList

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

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

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

This method tests for !=.

impl PartialOrd<TransformExtensionList> for TransformExtensionList

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

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

fn lt(&self, other: &TransformExtensionList) -> bool

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

fn le(&self, other: &TransformExtensionList) -> bool

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

fn gt(&self, other: &TransformExtensionList) -> bool

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

fn ge(&self, other: &TransformExtensionList) -> bool

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

impl StructuralEq for TransformExtensionList

impl StructuralPartialEq for TransformExtensionList