Struct Locale 

pub struct Locale { /* private fields */ }

A language tag as the host reports it — "en", "en-US", "zh-Hans-CN". Carried inline rather than as a String so Env stays Copy: a view reads ui.env() every frame, and a tag that allocated would allocate on every one of them.

The core does not parse it. It is passed through to the view, which hands it to whatever formats dates and numbers — kui has no opinion about what is a language and what is a region.

Implementations

impl Locale

pub const CAP: usize = 31

Longest tag that fits. RFC 5646 allows longer in principle; 31 holds every tag anyone ships, including the script-and-region ones (zh-Hant-HK) and a private-use suffix.

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

None for a tag that is empty, longer than Locale::CAP, or not ASCII — the three things a well-formed language tag is not. A host that hands one of those over reads back “the host cannot tell”, which is true: what it said was not a tag.

pub fn as_str(&self) -> &str

Trait Implementations

impl Clone for Locale

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Locale

impl Debug for Locale

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

Formats the value using the given formatter.

impl Display for Locale

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

Formats the value using the given formatter.

impl Eq for Locale

impl PartialEq for Locale

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Locale