Sunbeam Studios

Our open-source projects, here for you!

icu_locale_core (2.1.1)

Published 2026-03-26 10:33:08 +00:00 by siennathesane

Installation

[registry]
default = "gitea"

[registries.gitea]
index = "sparse+" # Sparse index
# index = "" # Git

[net]
git-fetch-with-cli = true
cargo add icu_locale_core@2.1.1

About this package

API for managing Unicode Language and Locale Identifiers

icu_locale_core crates.io

Parsing, manipulating, and serializing Unicode Language and Locale Identifiers.

This module is published as its own crate (icu_locale_core) and as part of the icu crate. See the latter for more details on the ICU4X project.

The module provides algorithms for parsing a string into a well-formed language or locale identifier as defined by UTS #35: Unicode LDML 3. Unicode Language and Locale Identifiers. Additionally the module provides [preferences] interface for operations on locale preferences and conversions from and to locale unicode extensions.

[Locale] is the most common structure to use for storing information about a language, script, region, variants and extensions. In almost all cases, this struct should be used as the base unit for all locale management operations.

[LanguageIdentifier] is a strict subset of [Locale] which can be useful in a narrow range of cases where Unicode Extensions are not relevant.

If in doubt, use [Locale].

Examples

use icu::locale::Locale;
use icu::locale::{
    locale,
    subtags::{language, region},
};

let mut loc: Locale = locale!("en-US");

assert_eq!(loc.id.language, language!("en"));
assert_eq!(loc.id.script, None);
assert_eq!(loc.id.region, Some(region!("US")));
assert_eq!(loc.id.variants.len(), 0);

loc.id.region = Some(region!("GB"));

assert_eq!(loc, locale!("en-GB"));

For more details, see [Locale] and [LanguageIdentifier].

More Information

For more information on development, authorship, contributing etc. please visit ICU4X home page.

Dependencies

ID Version
databake ^0.2.0
displaydoc ^0.2.3
litemap ^0.8.0
serde ^1.0.220
tinystr ^0.8.0
writeable ^0.6.0
zerovec ^0.11.3
Details
Cargo
2026-03-26 10:33:08 +00:00
0
The ICU4X Project Developers
Unicode-3.0
69 KiB
Assets (1)
Versions (1) View all
2.1.1 2026-03-26