Cldr.Number.Symbol (Cldr Numbers v2.16.0) View Source

Functions to manage the symbol definitions for a locale and number system.

Link to this section Summary

Types

t()

Functions

all_decimal_symbols(backend)

Returns a list of all decimal symbols defined by the locales configured in the given backend as a list.

all_decimal_symbols_class(backend)

Returns a list of all decimal symbols defined by the locales configured in the given backend as a string.

all_grouping_symbols(backend)

Returns a list of all grouping symbols defined by the locales configured in the given backend as a list.

all_grouping_symbols_class(backend)

Returns a list of all grouping symbols defined by the locales configured in the given backend as a string.

number_symbols_for(locale, backend)

Returns a map of Cldr.Number.Symbol.t structs of the number symbols for each of the number systems of a locale.

number_symbols_for(locale, number_system, backend)

Returns the number sysbols for a specific locale and number system.

Link to this section Types

t()

Specs

t() :: %Cldr.Number.Symbol{
  decimal: String.t(),
  exponential: String.t(),
  group: String.t(),
  infinity: String.t(),
  list: String.t(),
  minus_sign: String.t(),
  nan: String.t(),
  per_mille: String.t(),
  percent_sign: String.t(),
  plus_sign: String.t(),
  superscripting_exponent: String.t(),
  time_separator: String.t()
}

Link to this section Functions

all_decimal_symbols(backend)

Returns a list of all decimal symbols defined by the locales configured in the given backend as a list.

Arguments

backend is any module that includes use Cldr and therefore is a Cldr backend module

all_decimal_symbols_class(backend)

Returns a list of all decimal symbols defined by the locales configured in the given backend as a string.

This string can be used as a character class when builing a regular expression.

Arguments

backend is any module that includes use Cldr and therefore is a Cldr backend module

all_grouping_symbols(backend)

Returns a list of all grouping symbols defined by the locales configured in the given backend as a list.

Arguments

backend is any module that includes use Cldr and therefore is a Cldr backend module

all_grouping_symbols_class(backend)

Returns a list of all grouping symbols defined by the locales configured in the given backend as a string.

This string can be used as a character class when builing a regular expression.

Arguments

backend is any module that includes use Cldr and therefore is a Cldr backend module

number_symbols_for(locale, backend)

Specs

number_symbols_for(
  Cldr.LanguageTag.t() | Cldr.Locale.locale_name(),
  Cldr.backend()
) :: {:ok, map()} | {:error, {module(), String.t()}}

Returns a map of Cldr.Number.Symbol.t structs of the number symbols for each of the number systems of a locale.

Arguments

locale is any valid locale name returned by Cldr.known_locale_names/1 or a Cldr.LanguageTag struct returned by Cldr.Locale.new!/2. The default is Cldr.get_locale/1.
backend is any module that includes use Cldr and therefore is a Cldr backend module

Example:

iex> Cldr.Number.Symbol.number_symbols_for("th", TestBackend.Cldr)
{:ok, %{
   latn: %Cldr.Number.Symbol{
     decimal: ".",
     exponential: "E",
     group: ",",
     infinity: "∞",
     list: ";",
     minus_sign: "-",
     nan: "NaN",
     per_mille: "‰",
     percent_sign: "%",
     plus_sign: "+",
     superscripting_exponent: "×",
     time_separator: ":"
   },
   thai: %Cldr.Number.Symbol{
     decimal: ".",
     exponential: "E",
     group: ",",
     infinity: "∞",
     list: ";",
     minus_sign: "-",
     nan: "NaN",
     per_mille: "‰",
     percent_sign: "%",
     plus_sign: "+",
     superscripting_exponent: "×",
     time_separator: ":"
   }
 }}

number_symbols_for(locale, number_system, backend)

Specs

number_symbols_for(
  Cldr.LanguageTag.t() | Cldr.Locale.locale_name(),
  Cldr.Number.System.system_name(),
  Cldr.backend()
) :: {:ok, map()} | {:error, {Cldr.NoNumberSymbols, String.t()}}

Returns the number sysbols for a specific locale and number system.

Options

locale is any valid locale name returned by Cldr.known_locale_names/1 or a Cldr.LanguageTag struct returned by Cldr.Locale.new!/2. The default is Cldr.get_locale/1.
number_system is any number system name returned by Cldr.known_number_systems/0 or a number system type returned by Cldr.known_number_system_types/0
backend is any module that includes use Cldr and therefore is a Cldr backend module

Example

iex> Cldr.Number.Symbol.number_symbols_for("th", "thai", TestBackend.Cldr)
{:ok, %Cldr.Number.Symbol{
   decimal: ".",
   exponential: "E",
   group: ",",
   infinity: "∞",
   list: ";",
   minus_sign: "-",
   nan: "NaN",
   per_mille: "‰",
   percent_sign: "%",
   plus_sign: "+",
   superscripting_exponent: "×",
   time_separator: ":"
 }}