Struct unic_locale_impl::extensions::UnicodeExtensionList

pub struct UnicodeExtensionList { /* fields omitted */ }

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

Unicode extensions provide subtags that specify language and/or locale-based behavior or refinements to language tags, according to work done by the Unicode Consortium. (See RFC 6067 for details).

Examples

use unic_locale_impl::Locale;

let mut loc: Locale = "de-u-hc-h12-ca-buddhist".parse()
    .expect("Parsing failed.");

assert_eq!(loc.extensions.unicode.get_keyword("ca")
              .expect("Getting keyword failed.")
              .collect::<Vec<_>>(),
           &["buddhist"]);

Methods

impl UnicodeExtensionList

pub fn is_empty(&self) -> bool

Returns true if there are no keywords and no attributes in the UnicodeExtensionList.

Examples

use unic_locale_impl::Locale;

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

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

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

Returns the value of keyword in the UnicodeExtensionList.

Examples

use unic_locale_impl::Locale;

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

assert_eq!(loc.extensions.unicode.get_keyword("ca")
               .expect("Getting keyword failed.")
               .collect::<Vec<_>>(),
           &["buddhist"]);

// Here keyword with key "aa" is not available
assert_eq!(loc.extensions.unicode.get_keyword("aa")
              .expect("Getting keyword failed.")
              .len(),
           0);

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

Returns an iterator over all keys in the UnicodeExtensionList.

Examples

use unic_locale_impl::Locale;

let mut loc: Locale = "en-US-u-ca-buddhist-nu-thai".parse()
    .expect("Parsing failed.");

assert_eq!(loc.extensions.unicode.get_keyword_keys().collect::<Vec<_>>(),
           &["ca", "nu"]);

pub fn set_keyword<S: AsRef<[u8]>>(
    &mut self,
    key: S,
    value: &[S]
) -> Result<(), LocaleError>

Adds a keyword to the UnicodeExtensionList or sets value for key if keyword is already included in the UnicodeExtensionList.

Examples

use unic_locale_impl::Locale;

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

loc.extensions.unicode.set_keyword("ca", &["buddhist"])
    .expect("Setting keyword failed.");

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

loc.extensions.unicode.set_keyword("ca", &["chinese"])
    .expect("Setting keyword failed.");

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

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

Removes a keyword from the UnicodeExtensionList.

Returns true if keyword was included in the UnicodeExtensionList before removal.

Examples

use unic_locale_impl::Locale;

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

assert_eq!(loc.extensions.unicode.remove_keyword("ca")
              .expect("Removing tag failed."),
           true);

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

pub fn clear_keywords(&mut self)

Clears all keywords from the UnicodeExtensionList.

Examples

use unic_locale_impl::Locale;

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

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

pub fn has_attribute<S: AsRef<[u8]>>(
    &self,
    attribute: S
) -> Result<bool, LocaleError>

Returns true if attribute is included in the UnicodeExtensionList.

Examples

use unic_locale_impl::Locale;

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

assert_eq!(loc.extensions.unicode.has_attribute("foo")
              .expect("Getting attribute failed."),
           true);

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

Returns an iterator over all attributes in the UnicodeExtensionList.

Examples

use unic_locale_impl::Locale;

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

assert_eq!(loc.extensions.unicode.get_attributes().collect::<Vec<_>>(),
           &["bar", "foo"]);

pub fn set_attribute<S: AsRef<[u8]>>(
    &mut self,
    attribute: S
) -> Result<(), LocaleError>

Sets an attribute on the UnicodeExtensionList.

Examples

use unic_locale_impl::Locale;

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

loc.extensions.unicode.set_attribute("foo")
    .expect("Setting attribute failed.");

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

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

Removes an attribute from the UnicodeExtensionList.

Returns true if attribute was included in the UnicodeExtensionList before removal.

Examples

use unic_locale_impl::Locale;

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

assert_eq!(loc.extensions.unicode.remove_attribute("foo")
              .expect("Removing attribute failed."),
           true);

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

pub fn clear_attributes(&mut self)

Clears all attributes from the UnicodeExtensionList.

Examples

use unic_locale_impl::Locale;

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

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

Trait Implementations

impl Clone for UnicodeExtensionList

fn clone(&self) -> UnicodeExtensionList

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for UnicodeExtensionList

fn default() -> UnicodeExtensionList

Returns the "default value" for a type.

impl Eq for UnicodeExtensionList

impl PartialEq<UnicodeExtensionList> for UnicodeExtensionList

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

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

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

This method tests for !=.

impl Display for UnicodeExtensionList

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

Formats the value using the given formatter.

impl Debug for UnicodeExtensionList

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

Formats the value using the given formatter.

impl Hash for UnicodeExtensionList

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 StructuralPartialEq for UnicodeExtensionList

impl StructuralEq for UnicodeExtensionList