Struct i18n_embed::gettext::GettextLanguageLoader

pub struct GettextLanguageLoader { /* private fields */ }

LanguageLoader implementation for the gettext localization system.

⚠️ This API requires the following crate features to be activated: gettext-system.

Implementations

impl GettextLanguageLoader

pub fn new(module: &'static str, fallback_language: LanguageIdentifier) -> Self

Create a new GettextLanguageLoader.

Example

use i18n_embed::gettext::GettextLanguageLoader;

GettextLanguageLoader::new(module_path!(), "en".parse().unwrap());

Trait Implementations

impl Debug for GettextLanguageLoader

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

Formats the value using the given formatter.

impl LanguageLoader for GettextLanguageLoader

fn fallback_language(&self) -> &LanguageIdentifier

The fallback language for the module this loader is responsible for.

fn domain(&self) -> &'static str

The domain for the translation that this loader is associated with.

fn language_file_name(&self) -> String

The language file name to use for this loader’s domain.

fn current_language(&self) -> LanguageIdentifier

Get the language which is currently loaded for this loader.

fn load_languages(
    &self,
    i18n_assets: &dyn I18nAssets,
    language_ids: &[&LanguageIdentifier]
) -> Result<(), I18nEmbedError>

Load the languages language_ids using the resources packaged in the i18n_assets in order of fallback preference. This also sets the LanguageLoader::current_language() to the first in the language_ids slice. You can use select() to determine which fallbacks are actually available for an arbitrary slice of preferences.

Note: Gettext doesn’t support loading multiple languages as multiple fallbacks. We only load the first of the requested languages, and the fallback is the src language.

fn language_file<'a>(
    &self,
    language_id: &LanguageIdentifier,
    i18n_assets: &'a dyn I18nAssets
) -> (String, Option<Cow<'a, [u8]>>)

The computed path to the language file, and Cow of the file itself if it exists.

fn available_languages(
    &self,
    i18n_assets: &dyn I18nAssets
) -> Result<Vec<LanguageIdentifier>, I18nEmbedError>

Calculate the languages which are available to be loaded.

fn load_fallback_language(
    &self,
    i18n_assets: &dyn I18nAssets
) -> Result<(), I18nEmbedError>

Load the LanguageLoader::fallback_language().