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 Cldr.Print.Backend.known_locale_names/0 and the locales for which Cardinal 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

Arguments

• number is any integer, float or Decimal

• locale is any locale returned by Cldr.Locale.new!/2 or any locale_name returned by Cldr.Print.Backend.known_locale_names/0

• rounding is one of [:down, :up, :ceiling, :floor, :half_even, :half_up, :half_down]. The default is :half_even.

examples

Examples

iex> Cldr.Print.Backend.Number.Cardinal.plural_rule 0, "fr"
:one

iex> Cldr.Print.Backend.Number.Cardinal.plural_rule 0, "en"
:other

@spec plural_rules() :: map()

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

Arguments

• locale is any locale returned by Cldr.Print.Backend.Locale.new!/1 or any locale_name returned by Cldr.Print.Backend.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 cardinal plural rules and a substitution map.

arguments

Arguments

• number is an integer, float or Decimal

• locale is any locale returned by Cldr.Print.Backend.Locale.new!/1 or any locale_name returned by Cldr.Print.Backend.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 Cldr.Print.Backend.Number.Cardinal.Cardinal.plural_rule/3.

examples

Examples

iex> Cldr.Print.Backend.Number.Cardinal.pluralize 1, "en", %{one: "one"}
"one"

iex> Cldr.Print.Backend.Number.Cardinal.pluralize 2, "en", %{one: "one"}
nil

iex> Cldr.Print.Backend.Number.Cardinal.pluralize 2, "en", %{one: "one", two: "two", other: "other"}
"other"

iex> Cldr.Print.Backend.Number.Cardinal.pluralize 22, "en", %{one: "one", two: "two", other: "other"}
"other"

iex> Cldr.Print.Backend.Number.Cardinal.pluralize Decimal.new(1), "en", %{one: "one"}
"one"

iex> Cldr.Print.Backend.Number.Cardinal.pluralize Decimal.new(2), "en", %{one: "one"}
nil

iex> Cldr.Print.Backend.Number.Cardinal.pluralize Decimal.new(2), "en", %{one: "one", two: "two"}
nil

iex> Cldr.Print.Backend.Number.Cardinal.pluralize 1..10, "ar", %{one: "one", few: "few", other: "other"}
"few"

iex> Cldr.Print.Backend.Number.Cardinal.pluralize 1..10, "en", %{one: "one", few: "few", other: "other"}
"other"