Struct Catalog 

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

Immutable, shareable parsed catalogs. Replacing a catalog replaces its cache identity.

Implementations

impl Catalog

pub fn from_resources( fallback: &str, resources: &[Resource<'_>], ) -> Result<Self, LocalizationError>

Parses catalogs once, rejecting malformed resources and duplicate definitions. Missing translations fall back to fallback, then the message’s inline source.

pub fn with_languages( self, entries: &[(&str, &str)], ) -> Result<Self, LocalizationError>

Declares supported languages in presentation order with their native names. Every catalog language must occur exactly once; dependency catalogs do not add choices to an application’s language selector.

pub fn languages(&self) -> &[Language]

Supported application languages, in their declared presentation order.

pub fn with_fallback(self, library: &Catalog) -> Self

Adds a library’s catalogs below application overrides without copying its resources. Lookup prefers an application message in the same language before the library’s.

pub fn translator(&self, locale: Locale) -> Translator

Creates a thread-owned formatter for an explicit language.

pub fn negotiate(&self, preferences: &[Locale]) -> Translator

Negotiates ordered user preferences, preserving script subtags. An empty list selects the catalog’s source language. The resulting formatter stays on the calling thread; pass a cloned catalog to background workers.

pub fn fallback_locale(&self) -> &Locale

The source language used when no requested translation is available.

Trait Implementations

impl Clone for Catalog

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl PartialEq for Catalog

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

Equality operator ==.

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

Inequality operator !=.