Struct Locale 

pub struct Locale(/* private fields */);

BCP-47 locale tag (e.g. en-US, fr-FR).

Stores the lower-cased language and upper-cased region so locale vectors from different OS surfaces (navigator.language versus Accept-Language versus a manual setlocale call) collapse to the same canonical form.

Example

use stygian_proxy::ports::coherence::Locale;
let l = Locale::new("en-us").unwrap();
assert_eq!(l.as_str(), "en-US");
assert_eq!(l.language(), "en");
assert_eq!(l.region().unwrap(), "US");
assert!(Locale::new("en").is_none());

Implementations

impl Locale

pub fn new(raw: &str) -> Option<Self>

Parse a BCP-47 locale with both a language and a region subtag (e.g. en-US, fr-FR). Returns None for bare language tags (en) since the country↔locale check requires a region.

pub fn as_str(&self) -> &str

Returns the canonical lang-REGION form.

pub fn language(&self) -> &str

Lower-cased language subtag (en, fr, …).

pub fn region(&self) -> Option<&str>

Upper-cased region subtag (US, FR, …).

Trait Implementations

impl Clone for Locale

fn clone(&self) -> Locale

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Locale

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Locale

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Locale

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

Formats the value using the given formatter.

impl Eq for Locale

impl Hash for Locale

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 Locale

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Locale

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Locale