Struct Extensions 

#[non_exhaustive]
pub struct Extensions {
    pub unicode: Unicode,
    pub transform: Transform,
    pub private: Private,
    pub other: &'static [Other],
}

A map of extensions associated with a given Locale.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

unicode: Unicode

A representation of the data for a Unicode extension, when present in the locale identifier.

transform: Transform

A representation of the data for a transform extension, when present in the locale identifier.

private: Private

A representation of the data for a private-use extension, when present in the locale identifier.

other: &'static [Other]

A sequence of any other extensions that are present in the locale identifier but are not formally defined and represented explicitly as Unicode, Transform, and Private are.

Implementations

impl Extensions

pub const fn new() -> Self

Returns a new empty map of extensions. Same as default(), but is const.

Examples

use icu::locale::extensions::Extensions;

assert_eq!(Extensions::new(), Extensions::default());

pub const fn from_unicode(unicode: Unicode) -> Self

Function to create a new map of extensions containing exactly one unicode extension, callable in const context.

pub fn is_empty(&self) -> bool

Returns whether there are no extensions present.

Examples

use icu::locale::Locale;

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

assert!(!loc.extensions.is_empty());

pub fn total_cmp(&self, other: &Self) -> Ordering

Returns an ordering suitable for use in BTreeSet.

The ordering may or may not be equivalent to string ordering, and it may or may not be stable across ICU4X releases.

pub fn retain_by_type<F>(&mut self, predicate: F)

where F: FnMut(ExtensionType) -> bool,

Retains the specified extension types, clearing all others.

Examples

use icu::locale::extensions::ExtensionType;
use icu::locale::Locale;

let loc: Locale =
    "und-a-hello-t-mul-u-world-z-zzz-x-extra".parse().unwrap();

let mut only_unicode = loc.clone();
only_unicode
    .extensions
    .retain_by_type(|t| t == ExtensionType::Unicode);
assert_eq!(only_unicode, "und-u-world".parse().unwrap());

let mut only_t_z = loc.clone();
only_t_z.extensions.retain_by_type(|t| {
    t == ExtensionType::Transform || t == ExtensionType::Other(b'z')
});
assert_eq!(only_t_z, "und-t-mul-z-zzz".parse().unwrap());

Trait Implementations

impl Clone for Extensions

fn clone(&self) -> Extensions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Extensions

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

Formats the value using the given formatter.

impl Default for Extensions

fn default() -> Extensions

Returns the “default value” for a type.

impl Hash for Extensions

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Extensions

fn eq(&self, other: &Extensions) -> 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 Eq for Extensions

impl StructuralPartialEq for Extensions