Struct icu_provider_adapters::fallback::LocaleFallbacker

source · [−]

pub struct LocaleFallbacker { /* private fields */ }

Expand description

Entry type for locale fallbacking.

See the module-level documentation for an example.

Implementations

source

impl LocaleFallbacker

source

pub fn try_new_unstable(provider: &P) -> Result<Self, DataError>where
P: DataProvider<LocaleFallbackLikelySubtagsV1Marker> + DataProvider<LocaleFallbackParentsV1Marker> + DataProvider<CollationFallbackSupplementV1Marker> + ?Sized,

Creates a LocaleFallbacker with fallback data (likely subtags and parent locales).

📚 Help choosing a constructor

⚠️ The bounds on this function may change over time, including in SemVer minor releases.

source

pub fn try_new_with_any_provider(
provider: &impl AnyProvider + ?Sized
) -> Result<Self, DataError>

Creates a new instance using an AnyProvider.

For details on the behavior of this function, see: Self::try_new_unstable

📚 Help choosing a constructor

source

pub fn new_without_data() -> Self

Creates a LocaleFallbacker without fallback data. Using this constructor may result in surprising behavior, especially in multi-script languages.

source

pub fn for_config(
&self,
config: LocaleFallbackConfig
) -> LocaleFallbackerWithConfig<'_>

Creates the intermediate LocaleFallbackerWithConfig with configuration options.

source

pub fn for_key(&self, data_key: DataKey) -> LocaleFallbackerWithConfig<'_>

Creates the intermediate LocaleFallbackerWithConfig based on a DataKey and a DataRequestMetadata.

Examples

use icu_provider::prelude::*;
use icu_provider_adapters::fallback::LocaleFallbacker;
use std::borrow::Cow;

// Define the data struct with key.
#[icu_provider::data_struct(marker(
    FooV1Marker,
    "demo/foo@1",
    fallback_by = "region"
))]
pub struct FooV1<'data> {
    message: Cow<'data, str>,
};

// Set up the fallback iterator.
let fallbacker =
    LocaleFallbacker::try_new_unstable(&icu_testdata::unstable())
        .expect("data");
let key_fallbacker = fallbacker.for_key(FooV1Marker::KEY);
let mut fallback_iterator =
    key_fallbacker.fallback_for(icu_locid::locale!("en-GB").into());

// Run the algorithm and check the results.
assert_eq!(fallback_iterator.get().to_string(), "en-GB");
fallback_iterator.step();
assert_eq!(fallback_iterator.get().to_string(), "und-GB");
fallback_iterator.step();
assert_eq!(fallback_iterator.get().to_string(), "und");