11 releases (7 stable)
2.0.0-beta1 | Nov 23, 2024 |
---|---|
1.5.0 | May 28, 2024 |
1.4.0 | Nov 16, 2023 |
1.2.0 | Apr 14, 2023 |
0.0.1 | Apr 29, 2021 |
#393 in Internationalization (i18n)
106,832 downloads per month
Used in 48 crates
(10 directly)
375KB
6K
SLoC
icu_list
Formatting lists in a locale-sensitive way.
This module is published as its own crate (icu_list
)
and as part of the icu
crate. See the latter for more details on the ICU4X project.
Examples
Formatting and lists in Spanish
let list_formatter = ListFormatter::try_new_and(
locale!("es").into(),
ListFormatterOptions::default().with_length(ListLength::Wide),
)
.expect("locale should be present");
assert_writeable_eq!(
list_formatter.format(["España", "Suiza"].iter()),
"España y Suiza",
);
// The Spanish 'y' sometimes becomes an 'e':
assert_writeable_eq!(
list_formatter.format(["España", "Suiza", "Italia"].iter()),
"España, Suiza e Italia",
);
Formatting or lists in Thai
let list_formatter = ListFormatter::try_new_or(
locale!("th").into(),
ListFormatterOptions::default().with_length(ListLength::Short),
)
.expect("locale should be present");
// We can use any Writeables as inputs
assert_writeable_eq!(list_formatter.format(1..=3), "1, 2 หรือ 3",);
Formatting unit lists in English
let list_formatter = ListFormatter::try_new_unit(
locale!("en").into(),
ListFormatterOptions::default().with_length(ListLength::Wide),
)
.expect("locale should be present");
assert_writeable_eq!(
list_formatter.format(["1ft", "2in"].iter()),
"1ft, 2in",
);
Note: this last example is not fully internationalized. See icu4x/2192 for full unit handling.
More Information
For more information on development, authorship, contributing etc. please visit ICU4X home page
.
Dependencies
~2.7–4MB
~66K SLoC