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)

Download history 21569/week @ 2024-08-18 22376/week @ 2024-08-25 22714/week @ 2024-09-01 23277/week @ 2024-09-08 25219/week @ 2024-09-15 54520/week @ 2024-09-22 59275/week @ 2024-09-29 54729/week @ 2024-10-06 29809/week @ 2024-10-13 24911/week @ 2024-10-20 23945/week @ 2024-10-27 25724/week @ 2024-11-03 26262/week @ 2024-11-10 27344/week @ 2024-11-17 25586/week @ 2024-11-24 24616/week @ 2024-12-01

106,832 downloads per month
Used in 48 crates (10 directly)

Unicode-3.0

375KB
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(
    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