Struct ULoc

pub struct ULoc { /* private fields */ }

A representation of a Unicode locale.

For the time being, only basic conversion and methods are in fact implemented.

To get basic validation when creating a locale, use for_language_tag with a Unicode BCP-47 locale ID.

Implementations

impl ULoc

pub fn language(&self) -> Option<String>

Implements uloc_getLanguage.

pub fn script(&self) -> Option<String>

Implements uloc_getScript.

pub fn country(&self) -> Option<String>

Implements uloc_getCountry.

pub fn variant(&self) -> Option<String>

Implements uloc_getVariant.

pub fn name(&self) -> Option<String>

Implements uloc_getName.

pub fn canonicalize(&self) -> Result<ULoc, Error>

Implements uloc_canonicalize from ICU4C.

pub fn iso3_language(&self) -> Option<String>

Implements ‘uloc_getISO3Language’ from ICU4C.

pub fn iso3_country(&self) -> Option<String>

Implements ‘uloc_getISO3Country’ from ICU4C.

pub fn display_language(&self, display_locale: &ULoc) -> Result<UChar, Error>

Implements uloc_getDisplayLanguage.

pub fn display_script(&self, display_locale: &ULoc) -> Result<UChar, Error>

Implements uloc_getDisplayScript.

pub fn display_country(&self, display_locale: &ULoc) -> Result<UChar, Error>

Implements uloc_getDisplayCountry.

pub fn display_variant(&self, display_locale: &ULoc) -> Result<UChar, Error>

Implements uloc_getDisplayVariant.

pub fn display_keyword( keyword: &String, display_locale: &ULoc, ) -> Result<UChar, Error>

Implements uloc_getDisplayKeyword.

pub fn display_keyword_value( &self, keyword: &String, display_locale: &ULoc, ) -> Result<UChar, Error>

Implements uloc_getDisplayKeywordValue.

pub fn display_name(&self, display_locale: &ULoc) -> Result<UChar, Error>

Implements uloc_getDisplayName.

pub fn count_available() -> i32

Implements uloc_countAvailable.

pub fn get_available(n: i32) -> Result<ULoc, Error>

Implements uloc_getAvailable.

pub fn get_available_locales() -> Vec<ULoc>

Returns a vector of available locales

pub fn open_available_by_type( locale_type: ULocAvailableType, ) -> Result<Enumeration, Error>

Implements uloc_openAvailableByType.

pub fn get_available_locales_by_type( locale_type: ULocAvailableType, ) -> Vec<ULoc>

Returns a vector of locales of the requested type.

pub fn add_likely_subtags(&self) -> Result<ULoc, Error>

Implements uloc_addLikelySubtags from ICU4C.

pub fn minimize_subtags(&self) -> Result<ULoc, Error>

Implements uloc_minimizeSubtags from ICU4C.

pub fn to_language_tag(&self, strict: bool) -> Result<String, Error>

Implements uloc_toLanguageTag from ICU4C.

pub fn open_keywords(&self) -> Result<Enumeration, Error>

pub fn keywords(&self) -> impl Iterator<Item = String>

Implements uloc_openKeywords() from ICU4C.

pub fn unicode_keywords(&self) -> impl Iterator<Item = String>

Implements icu::Locale::getUnicodeKeywords() from the C++ API.

pub fn keyword_value(&self, keyword: &str) -> Result<Option<String>, Error>

Implements uloc_getKeywordValue() from ICU4C.

pub fn unicode_keyword_value( &self, unicode_keyword: &str, ) -> Result<Option<String>, Error>

Implements icu::Locale::getUnicodeKeywordValue() from the C++ API.

pub fn label(&self) -> &str

Returns the current label of this locale.

pub fn as_c_str(&self) -> CString

Returns the current locale name as a C string.

pub fn for_language_tag(tag: &str) -> Result<ULoc, Error>

Implements uloc_forLanguageTag from ICU4C.

Note that an invalid tag will cause that tag and all others to be ignored. For example en-us will work but en_US will not.

pub fn base_name(self) -> Self

Implements uloc_getBaseName from ICU4C.

Trait Implementations

impl Clone for ULoc

fn clone(&self) -> ULoc

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ULoc

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

Formats the value using the given formatter.

impl Display for ULoc

Implement the Display trait to convert the ULoc into string for display.

The string for display and string serialization happen to be the same for ULoc.

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

Formats the value using the given formatter.

impl From<ULoc> for ULocMut

fn from(l: ULoc) -> Self

Turns ULoc into ULocMut, which can be mutated.

impl From<ULocMut> for ULoc

fn from(lm: ULocMut) -> Self

Converts to this type from the input type.

impl Hash for ULoc

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

This implementation is based on ULocale.compareTo from ICU4J. See https://github.com/unicode-org/icu/blob/%6d%61%73%74%65%72/icu4j/main/classes/core/src/com/ibm/icu/util/ULocale.java

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

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

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

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ULoc

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

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl TryFrom<&CStr> for ULoc

fn try_from(s: &CStr) -> Result<Self, Self::Error>

Creates a new ULoc from a borrowed C string.

type Error = Error

The type returned in the event of a conversion error.

impl TryFrom<&str> for ULoc

fn try_from(s: &str) -> Result<Self, Self::Error>

Creates a new ULoc from a string slice.

The creation wil fail if the locale is nonexistent.

type Error = Error

The type returned in the event of a conversion error.

impl Eq for ULoc

impl StructuralPartialEq for ULoc