9 releases (2 stable)
1.1.0 | Jan 26, 2023 |
---|---|
1.0.0 | Sep 27, 2022 |
1.0.0-beta1 | Aug 5, 2022 |
0.6.0 | May 17, 2022 |
0.1.0 | Oct 15, 2020 |
#14 in #cldr
8,244 downloads per month
Used in 16 crates
(9 directly)
2MB
19K
SLoC
icu_plurals 
Determine the plural category appropriate for a given number in a given language.
This module is published as its own crate (icu_plural
)
and as part of the icu
crate. See the latter for more details on the ICU4X project.
For example in English, when constructing a message
such as { num } items
, the user has to prepare
two variants of the message:
1 item
0 items
,2 items
,5 items
,0.5 items
etc.
The former variant is used when the placeholder variable has value 1
,
while the latter is used for all other values of the variable.
Unicode defines Language Plural Rules as a mechanism to codify those
variants and provides data and algorithms to calculate
appropriate [PluralCategory
].
Examples
use icu::locid::locale;
use icu::plurals::{PluralCategory, PluralRuleType, PluralRules};
let pr = PluralRules::try_new_unstable(
&icu_testdata::unstable(),
&locale!("en").into(),
PluralRuleType::Cardinal,
)
.expect("Failed to construct a PluralRules struct.");
assert_eq!(pr.category_for(5_usize), PluralCategory::Other);
Plural Rules
The crate provides the main struct [PluralRules
] which handles selection
of the correct [PluralCategory
] for a given language and [PluralRuleType
].
Plural Category
Every number in every language belongs to a certain [PluralCategory
].
For example, the Polish language uses four:
PluralRuleType
Plural rules depend on the use case. This crate supports two types of plural rules:
More Information
For more information on development, authorship, contributing etc. please visit ICU4X home page
.