9 releases (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.0.1 Apr 29, 2021

#162 in Internationalization (i18n)

Download history 12448/week @ 2023-12-01 12754/week @ 2023-12-08 11708/week @ 2023-12-15 10057/week @ 2023-12-22 8673/week @ 2023-12-29 12624/week @ 2024-01-05 11659/week @ 2024-01-12 12223/week @ 2024-01-19 14381/week @ 2024-01-26 20083/week @ 2024-02-02 19615/week @ 2024-02-09 20029/week @ 2024-02-16 17498/week @ 2024-02-23 18567/week @ 2024-03-01 20535/week @ 2024-03-08 16944/week @ 2024-03-15

76,516 downloads per month
Used in 22 crates (6 directly)

Custom license

365KB
6K SLoC

icu_list crates.io

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_with_length(
    &locale!("es").into(),
    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_with_length(
    &locale!("th").into(),
    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_with_length(
    &locale!("en").into(),
    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

~5MB
~73K SLoC