13 releases (6 stable)

1.4.0 Nov 16, 2023
1.3.0 Sep 23, 2023
1.2.0 Apr 14, 2023
1.1.0 Jan 26, 2023
0.1.0 Oct 15, 2020

#8 in Internationalization (i18n)

Download history 14970/week @ 2023-12-23 17341/week @ 2023-12-30 19875/week @ 2024-01-06 21161/week @ 2024-01-13 21492/week @ 2024-01-20 25724/week @ 2024-01-27 29067/week @ 2024-02-03 29216/week @ 2024-02-10 30297/week @ 2024-02-17 28335/week @ 2024-02-24 29019/week @ 2024-03-02 31614/week @ 2024-03-09 31354/week @ 2024-03-16 29498/week @ 2024-03-23 27281/week @ 2024-03-30 24657/week @ 2024-04-06

117,942 downloads per month
Used in 141 crates (42 directly)

Custom license

525KB
9K SLoC

icu_locid crates.io

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

This module is published as its own crate (icu_locid) 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.

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::locid::Locale;
use icu::locid::{
    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

~0.3–0.9MB
~20K SLoC