View Source MyApp.Cldr.Number.Ordinal (Cldr v2.39.2)
Implements ordinal plural rules for numbers.
Summary
Functions
The locale names for which plural rules are defined.
The configured locales for which plural rules are defined.
Return the plural key for a given number in a given locale
Returns all the plural rules defined in CLDR.
Return the plural rules for a locale.
Pluralize a number using ordinal plural rules and a substitution map.
Functions
The locale names for which plural rules are defined.
@spec known_locale_names() :: [Cldr.Locale.locale_name(), ...]
The configured locales for which plural rules are defined.
Returns the intersection of MyApp.Cldr.known_locale_names/0
and
the locales for which Ordinal plural rules are defined.
There are many Cldr
locales which don't have their own plural
rules so this list is the intersection of Cldr
's configured
locales and those that have rules.
@spec plural_rule( Cldr.Math.number_or_decimal(), Cldr.Locale.locale_name() | Cldr.LanguageTag.t(), atom() | pos_integer() ) :: Cldr.Number.PluralRule.plural_type()
Return the plural key for a given number in a given locale
Returns which plural key (:zero
, :one
, :two
, :few
,
:many
or :other
) a given number fits into within the
context of a given locale.
Note that these key names should not be interpreted
literally. For example, the key returned from
Cldr.Number.Ordinal.plural_rule(0, "en")
is actually
:other
, not :zero
.
This key can then be used to format a number, date, time, unit, list or other content in a plural-sensitive way.
Arguments
number
is anyinteger
,float
orDecimal
locale
is any locale returned byCldr.Locale.new!/2
or anylocale_name
returned byMyApp.Cldr.known_locale_names/0
rounding
is one of[:down, :up, :ceiling, :floor, :half_even, :half_up, :half_down]
. The default is:half_even
.
Examples
iex> MyApp.Cldr.Number.Ordinal.plural_rule 0, "fr"
:other
iex> MyApp.Cldr.Number.Ordinal.plural_rule 1, "en"
:one
@spec plural_rules() :: %{ required(Cldr.Locale.locale_name()) => [ {plural_type :: Cldr.Number.PluralRule.plural_type(), plural_rules :: [Cldr.Number.PluralRule.plural_rule(), ...]}, ... ] }
Returns all the plural rules defined in CLDR.
@spec plural_rules_for(Cldr.Locale.locale_name() | Cldr.LanguageTag.t()) :: [ {atom(), list()}, ... ]
Return the plural rules for a locale.
Arguments
locale
is any locale returned byMyApp.Cldr.Locale.new!/1
or anylocale_name
returned byMyApp.Cldr.known_locale_names/0
The rules are returned in AST form after parsing.
@spec pluralize( Cldr.Math.number_or_decimal() | Range.t(), Cldr.Locale.locale_reference(), %{} ) :: any()
Pluralize a number using ordinal plural rules and a substitution map.
Arguments
number
is an integer, float or Decimal or aRange.t{}
. When a range, The is that in any usage, the start value is strictly less than the end value, and that no values are negative. Results for any cases that do not meet these criteria are undefined.locale
is any locale returned byMyApp.Cldr.Locale.new!/1
or anylocale_name
returned byMyApp.Cldr.known_locale_names/0
substitutions
is a map that maps plural keys to a string. The valid substitution keys are:zero
,:one
,:two
,:few
,:many
and:other
.
See also MyApp.Cldr.Number.Ordinal.Ordinal.plural_rule/3
.
Examples
iex> MyApp.Cldr.Number.Ordinal.pluralize 1, :en, %{one: "one"}
"one"
iex> MyApp.Cldr.Number.Ordinal.pluralize 2, :en, %{one: "one"}
nil
iex> MyApp.Cldr.Number.Ordinal.pluralize 2, :en, %{one: "one", two: "two"}
"two"
iex> MyApp.Cldr.Number.Ordinal.pluralize 22, :en, %{one: "one", two: "two", other: "other"}
"two"
iex> MyApp.Cldr.Number.Ordinal.pluralize Decimal.new(1), :en, %{one: "one"}
"one"
iex> MyApp.Cldr.Number.Ordinal.pluralize Decimal.new(2), :en, %{one: "one"}
nil
iex> MyApp.Cldr.Number.Ordinal.pluralize Decimal.new(2), :en, %{one: "one", two: "two"}
"two"
iex> MyApp.Cldr.Number.Ordinal.pluralize 1..10, "ar", %{one: "one", few: "few", other: "other"}
"other"
iex> MyApp.Cldr.Number.Ordinal.pluralize 1..10, "en", %{one: "one", few: "few", other: "other"}
"other"