Enum I18nError 

pub enum I18nError {
    LocaleUnavailable(String),
    FormatError(String),
    Unavailable(String),
    Unknown(String),
}

Why a translate call failed. Ok(rendered) is the overwhelming majority path — every method here is reserved for a real backend failure the caller needs to decide about.

Variants

LocaleUnavailable(String)

The requested locale was promised by supported_locales() but could not be loaded: a missing file, a parse error, a corrupted bundle. Callers SHOULD retry with the fallback locale or surface a generic English string.

FormatError(String)

A bundle loaded fine but formatting the specific key failed: an ICU MessageFormat placeholder that did not match the variable bag, a Fluent function call error, a type mismatch between a variable and the pattern that consumed it.

Unavailable(String)

The backend is in a state where it cannot serve any translations right now — an async reload is in flight, a file watcher caught a broken state, a cache eviction storm. Transient; callers MAY retry.

Unknown(String)

The backend hit something it could not classify. Treat as Unavailable unless you know better.

Implementations

impl I18nError

pub fn locale_unavailable(msg: impl Into<String>) -> Self

pub fn format_error(msg: impl Into<String>) -> Self

pub fn unavailable(msg: impl Into<String>) -> Self

pub fn unknown(msg: impl Into<String>) -> Self

pub fn message(&self) -> &str

Trait Implementations

impl Clone for I18nError

fn clone(&self) -> I18nError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for I18nError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for I18nError

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for I18nError

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

Formats the value using the given formatter.

impl Error for I18nError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for I18nError

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for I18nError

impl StructuralPartialEq for I18nError