Struct rocket_accept_language::Locale
source · pub struct Locale { /* private fields */ }
Expand description
A Locale object.
Locale object stores information encoded in a language tag and provides methods allowing for parsing, serializing and manipulating locale fields.
All data is validated and canonicalized on input, which means that the output is always canonicalized.
Currently supported subtags are:
language
(e.g. “en”)script
(e.g. “Latn”)region
(e.g. “US”)variants
(e.g. “windows”)extensions
(e.g. “-u-ca-gregorian-hc-h12”)
The API parses correctly the remaining fields of the BCP47 language tag, but at the moment does not provide any API for operating on them.
Examples
Parsing
Locale supports a From
trait from String
and &str
:
use fluent_locale::Locale;
let loc = Locale::from("en-latn-us");
assert_eq!(loc.to_string(), "en-Latn-US");
Locale can also accept options, similarly to ECMA402 Intl.Locale:
use fluent_locale::Locale;
use std::collections::BTreeMap;
let mut opts = BTreeMap::new();
opts.insert("hour-cycle", "h12");
let loc = Locale::new("en", Some(opts)).unwrap();
assert_eq!(loc.to_string(), "en-u-hc-h12");
Serializing
Locale supports Display
trait allowing for:
use fluent_locale::Locale;
use std::collections::BTreeMap;
let mut opts = BTreeMap::new();
opts.insert("hour-cycle", "h12");
let loc = Locale::new("en-Latn-US-u-hc-h23", Some(opts)).unwrap();
assert_eq!(loc.to_string(), "en-Latn-US-u-hc-h12");
Manipulating
During the lifetime of Locale
, its fields can be modified via getter/setter
methods:
use fluent_locale::Locale;
let mut loc = Locale::from("en-Latn-US");
loc.set_region("GB").unwrap();
assert_eq!(loc.to_string(), "en-Latn-GB");
Implementations§
source§impl Locale
impl Locale
pub fn new(
loc_str: &str,
opts: Option<BTreeMap<&str, &str, Global>>
) -> Result<Locale, Error>
pub fn set_language(&mut self, value: &str) -> Result<(), Error>
pub fn get_language(&self) -> &str
pub fn set_script(&mut self, value: &str) -> Result<(), Error>
pub fn get_script(&self) -> &str
pub fn set_region(&mut self, value: &str) -> Result<(), Error>
pub fn get_region(&self) -> &str
pub fn add_variant(&mut self, value: String)
pub fn remove_variant(&mut self, value: String)
pub fn get_variants(&self) -> Vec<&String, Global> ⓘ
pub fn clear_variants(&mut self)
pub fn has_privateuse(&self) -> bool
pub fn get_extensions(
&self
) -> BTreeMap<String, &BTreeMap<String, String, Global>, Global>
pub fn add_extension(&mut self, ext_name: String, key: String, value: String)
pub fn matches(
&self,
other: &Locale,
available_range: bool,
requested_range: bool
) -> bool
Trait Implementations§
impl StructuralPartialEq for Locale
Auto Trait Implementations§
impl RefUnwindSafe for Locale
impl Send for Locale
impl Sync for Locale
impl Unpin for Locale
impl UnwindSafe for Locale
Blanket Implementations§
§impl<T> IntoCollection<T> for T
impl<T> IntoCollection<T> for T
§fn into_collection<A>(self) -> SmallVec<A>where
A: Array<Item = T>,
fn into_collection<A>(self) -> SmallVec<A>where
A: Array<Item = T>,
Converts
self
into a collection.