View Source TestBackend.Cldr.Territory (Cldr Territories v2.5.0)

Link to this section Summary

Functions

Returns a list of available styles.

Returns the available territory subdivisions for a given locale.

Returns the available territories for a given locale.

Lists children(s) for the given territory code. Returns {:ok, list} if successful, otherwise {:error, reason}.

The same as children/2, but raises an exception if it fails.

Checks relationship between two territories, where the first argument is the parent and second the child. Returns true if successful, otherwise false.

Returns a list of country codes.

Localized string for the given LanguageTag.t. Returns {:ok, String.t} if successful, otherwise {:error, reason}.

The same as from_language_tag/2, but raises an exception if it fails.

Localized string for the given subdivision code. Returns {:ok, String.t} if successful, otherwise {:error, reason}.

Localized string for the given territory code. Returns {:ok, String.t} if successful, otherwise {:error, reason}.

Maps territory info for the given territory code. Returns {:ok, map} if successful, otherwise {:error, reason}.

The same as info/1, but raises an exception if it fails.

Returns a map of all known territory subdivisions in a given locale.

Returns a map of all known territories in a given locale.

Returns a list of subdivisions of a given territory.

Lists parent(s) for the given territory code. Returns {:ok, list} if successful, otherwise {:error, reason}.

The same as parent/2, but raises an exception if it fails.

A helper method to get a territory's currency code if a territory has multiply currencies then the oldest active currency is returned. Returns {:ok, code} if successful, otherwise {:error, reason}.

The same as to_currency_code/2, but raises an exception if it fails.

A helper method to get a territory's currency codes. Returns {:ok, list} if successful, otherwise {:error, reason}.

The same as to_currency_codes/2, but raises an exception if it fails.

Unicode flag for the given territory code. Returns {:ok, flag} if successful, otherwise {:error, reason}.

The same as to_unicode_flag/1, but raises an exception if it fails.

Translate a LanguageTag.t into a localized string from one locale to another. Returns {:ok, result} if successful, otherwise {:error, reason}.

Translate a localized string from one locale to another. Returns {:ok, result} if successful, otherwise {:error, reason}.

Translate a localized string from one locale to another. Returns {:ok, result} if successful, otherwise {:error, reason}.

Link to this section Functions

Specs

available_styles() :: [:short | :standard | :variant]

Returns a list of available styles.

example

Example

iex> TestBackend.Cldr.Territory.available_styles()
[:short, :standard, :variant]
Link to this function

available_subdivisions(locale \\ TestBackend.Cldr.get_locale())

View Source

Specs

available_subdivisions(Cldr.Territory.atom_binary_tag()) ::
  [atom()] | {:error, Cldr.Territory.error()}

Returns the available territory subdivisions for a given locale.

example

Example

=> TestBackend.Cldr.Territory.available_subdivisions("en")
[:ad02, :ad03, :ad04, :ad05, :ad06, :ad07, :ad08, ...]

iex> TestBackend.Cldr.Territory.available_subdivisions()
[]

iex> TestBackend.Cldr.Territory.available_subdivisions("zzz")
{:error, {Cldr.InvalidLanguageError, "The language \"zzz\" is invalid"}}
Link to this function

available_territories(locale \\ TestBackend.Cldr.get_locale())

View Source

Specs

available_territories(Cldr.Territory.atom_binary_tag()) ::
  [atom()] | {:error, Cldr.Territory.error()}

Returns the available territories for a given locale.

example

Example

=> TestBackend.Cldr.Territory.available_territories()
[:"001", :"002", :"003", :"005", :"009", :"011", :"013", :"014", :"015", :"017",
:"018", :"019", :"021", :"029", :"030", :"034", :"035", :"039", :"053", :"054",
:"057", :"061", :"142", :"143", :"145", :"150", :"151", :"154", :"155", :"202",
:"419", :AC, :AD, :AE, :AF, :AG, :AI, :AL, :AM, :AO, :AQ, :AR, :AS, :AT, :AU,
:AW, :AX, :AZ, :BA, :BB, ...]

iex> TestBackend.Cldr.Territory.available_territories("zzz")
{:error, {Cldr.InvalidLanguageError, "The language \"zzz\" is invalid"}}
Link to this function

children(territory_code, opts \\ [as: :atom])

View Source

Specs

Lists children(s) for the given territory code. Returns {:ok, list} if successful, otherwise {:error, reason}.

  • options are:
    • as: :atom
    • as: :binary
    • as: :charlist

example

Example

iex> TestBackend.Cldr.Territory.children(:EU)
{:ok,
[:AT, :BE, :CY, :CZ, :DE, :DK, :EE, :ES, :FI, :FR, :GR, :HR, :HU, :IE,
  :IT, :LT, :LU, :LV, :MT, :NL, :PL, :PT, :SE, :SI, :SK, :BG, :RO]}

iex> TestBackend.Cldr.Territory.children(:ZZZ)
{:error, {Cldr.UnknownTerritoryError, "The territory :ZZZ is unknown"}}

iex> TestBackend.Cldr.Territory.children(:GB)
{:error, {Cldr.UnknownParentError, "The territory :GB has no children"}}
Link to this function

children!(territory_code, opts \\ [as: :atom])

View Source

Specs

The same as children/2, but raises an exception if it fails.

  • options are:
    • as: :atom
    • as: :binary
    • as: :charlist

example

Example

iex> TestBackend.Cldr.Territory.children!(:EU)
[:AT, :BE, :CY, :CZ, :DE, :DK, :EE, :ES, :FI, :FR, :GR, :HR, :HU, :IE, :IT,
:LT, :LU, :LV, :MT, :NL, :PL, :PT, :SE, :SI, :SK, :BG, :RO]
Link to this function

contains?(parent, child)

View Source

Specs

Checks relationship between two territories, where the first argument is the parent and second the child. Returns true if successful, otherwise false.

example

Example

iex> TestBackend.Cldr.Territory.contains?(:EU, :DK)
true

iex> TestBackend.Cldr.Territory.contains?(:DK, :EU)
false
Link to this function

country_codes(opts \\ [as: :atom])

View Source

Specs

Returns a list of country codes.

  • options are:
    • as: :atom
    • as: :binary
    • as: :charlist

example

Example

=> TestBackend.Cldr.Territory.country_codes()
[:AD, :AE, :AF, :AG, :AI, :AL, :AM, :AO, :AR, :AS, :AT, :AU, :AW,
:AX, :AZ, :BA, :BB, :BD, :BE, :BF, :BG, :BH, :BI, :BJ, :BL, :BM,
:BN, :BO, :BQ, :BR, :BS, :BT, :BV, :BW, :BY, :BZ, :CA, :CC, :CD,
:CF, :CG, :CH, :CI, :CK, :CL, :CM, :CN, :CO, :CR, :CU, ...]
Link to this function

from_language_tag(tag, options \\ [style: :standard])

View Source

Specs

from_language_tag(Cldr.Territory.tag(), Cldr.Territory.options()) ::
  {:ok, binary()} | {:error, Cldr.Territory.error()}

Localized string for the given LanguageTag.t. Returns {:ok, String.t} if successful, otherwise {:error, reason}.

example

Example

iex> TestBackend.Cldr.Territory.from_language_tag(Cldr.get_locale())
{:ok, "world"}

iex> TestBackend.Cldr.Territory.from_language_tag(Cldr.get_locale(), [style: :short])
{:error, {Cldr.UnknownStyleError, "The style :short is unknown"}}

iex> TestBackend.Cldr.Territory.from_language_tag(Cldr.get_locale(), [style: :ZZZ])
{:error, {Cldr.UnknownStyleError, "The style :ZZZ is unknown"}}

iex> TestBackend.Cldr.Territory.from_language_tag(Cldr.get_locale(), [style: "ZZZ"])
{:error, {Cldr.UnknownStyleError, "The style \"ZZZ\" is unknown"}}
Link to this function

from_language_tag!(tag, options \\ [style: :standard])

View Source

Specs

from_language_tag!(Cldr.Territory.tag(), Cldr.Territory.options()) :: binary()

The same as from_language_tag/2, but raises an exception if it fails.

example

Example

iex> TestBackend.Cldr.Territory.from_language_tag!(Cldr.get_locale())
"world"
Link to this function

from_subdivision_code(subdivision_code, options \\ [locale: TestBackend.Cldr.get_locale()])

View Source

Specs

from_subdivision_code(binary(), [{:locale, Cldr.Territory.atom_binary_tag()}]) ::
  {:ok, binary()} | {:error, Cldr.Territory.error()}

Localized string for the given subdivision code. Returns {:ok, String.t} if successful, otherwise {:error, reason}.

example

Example

iex> TestBackend.Cldr.Territory.from_subdivision_code("gbcma", locale: "en")
{:ok, "Cumbria"}

iex> TestBackend.Cldr.Territory.from_subdivision_code("gbcma", locale: "pl")
{:ok, "Kumbria"}

iex> TestBackend.Cldr.Territory.from_subdivision_code("gbcma", locale: "bs")
{:error, {Cldr.UnknownSubdivisionError, "The locale :bs has no translation for :gbcma."}}

iex> TestBackend.Cldr.Territory.from_subdivision_code("invalid", locale: "en")
{:error, {Cldr.UnknownTerritoryError, "The territory \"invalid\" is unknown"}}

iex> TestBackend.Cldr.Territory.from_subdivision_code("gbcma", [locale: :zzz])
{:error, {Cldr.InvalidLanguageError, "The language \"zzz\" is invalid"}}

iex> TestBackend.Cldr.Territory.from_subdivision_code("gbcma", [locale: "zzz"])
{:error, {Cldr.InvalidLanguageError, "The language \"zzz\" is invalid"}}
Link to this function

from_subdivision_code!(subdivision_code, options \\ [locale: TestBackend.Cldr.get_locale()])

View Source

Specs

from_subdivision_code!(binary(), [{:locale, Cldr.Territory.atom_binary_tag()}]) ::
  binary() | no_return()

The same as from_subdivision_code/2, but raises an exception if it fails.

example

Example

iex> TestBackend.Cldr.Territory.from_subdivision_code!("gbcma", locale: "en")
"Cumbria"

iex> TestBackend.Cldr.Territory.from_subdivision_code!("gbcma", locale: "pl")
"Kumbria"
Link to this function

from_territory_code(territory_code, options \\ [locale: TestBackend.Cldr.get_locale(), style: :standard])

View Source

Specs

from_territory_code(Cldr.Territory.atom_binary_tag(), Cldr.Territory.options()) ::
  {:ok, binary()} | {:error, Cldr.Territory.error()}

Localized string for the given territory code. Returns {:ok, String.t} if successful, otherwise {:error, reason}.

example

Example

iex> TestBackend.Cldr.Territory.from_territory_code(:GB)
{:ok, "United Kingdom"}

iex> TestBackend.Cldr.Territory.from_territory_code(:GB, [style: :short])
{:ok, "UK"}

iex> TestBackend.Cldr.Territory.from_territory_code(:GB, [style: :ZZZ])
{:error, {Cldr.UnknownStyleError, "The style :ZZZ is unknown"}}

iex> TestBackend.Cldr.Territory.from_territory_code(:GB, [style: "ZZZ"])
{:error, {Cldr.UnknownStyleError, "The style \"ZZZ\" is unknown"}}

iex> TestBackend.Cldr.Territory.from_territory_code(:GB, [locale: "pt"])
{:ok, "Reino Unido"}

iex> TestBackend.Cldr.Territory.from_territory_code(:GB, [locale: :zzz])
{:error, {Cldr.InvalidLanguageError, "The language \"zzz\" is invalid"}}

iex> TestBackend.Cldr.Territory.from_territory_code(:GB, [locale: "zzz"])
{:error, {Cldr.InvalidLanguageError, "The language \"zzz\" is invalid"}}
Link to this function

from_territory_code!(territory_code, options \\ [locale: TestBackend.Cldr.get_locale(), style: :standard])

View Source

Specs

The same as from_territory_code/2, but raises an exception if it fails.

example

Example

iex> TestBackend.Cldr.Territory.from_territory_code!(:GB)
"United Kingdom"

iex> TestBackend.Cldr.Territory.from_territory_code!(:GB, [style: :short])
"UK"

iex> TestBackend.Cldr.Territory.from_territory_code!(:GB, [locale: "pt"])
"Reino Unido"

Specs

info(Cldr.Territory.atom_tag()) ::
  {:ok, map()} | {:error, Cldr.Territory.error()}

Maps territory info for the given territory code. Returns {:ok, map} if successful, otherwise {:error, reason}.

example

Example

iex> TestBackend.Cldr.Territory.info(:GB)
{:ok,
 %{
   currency: [GBP: %{from: ~D[1694-07-27]}],
   gdp: 2925000000000,
   language_population: %{
    "ar" => %{population_percent: 0.3},
    "bn" => %{population_percent: 0.4},
    "cy" => %{official_status: "official_regional", population_percent: 1.3},
    "de" => %{population_percent: 9},
    "en" => %{official_status: "official", population_percent: 98},
    "es" => %{population_percent: 8},
    "fr" => %{population_percent: 23},
    "ga" => %{official_status: "official_regional", population_percent: 0.15},
    "gd" => %{
      official_status: "official_regional",
      population_percent: 0.11,
      writing_percent: 5
    },
    "gu" => %{population_percent: 2.9},
    "it" => %{population_percent: 0.2},
    "kw" => %{population_percent: 0.003},
    "lt" => %{population_percent: 0.2},
    "pa" => %{population_percent: 3.6},
    "pl" => %{population_percent: 4},
    "pt" => %{population_percent: 0.2},
    "sco" => %{population_percent: 2.5, writing_percent: 5},
    "so" => %{population_percent: 0.2},
    "ta" => %{population_percent: 3.2},
    "tr" => %{population_percent: 0.2},
    "ur" => %{population_percent: 3.5},
    "zh-Hant" => %{population_percent: 0.3}
   },
   literacy_percent: 99,
   measurement_system: %{
     default: :uksystem,
     paper_size: :a4,
     temperature: :uksystem
   },
   population: 65761100
 }}

Specs

The same as info/1, but raises an exception if it fails.

example

Example

iex> TestBackend.Cldr.Territory.info!(:GB)
%{
  currency: [GBP: %{from: ~D[1694-07-27]}],
  gdp: 2925000000000,
  language_population: %{
    "ar" => %{population_percent: 0.3},
    "bn" => %{population_percent: 0.4},
    "cy" => %{official_status: "official_regional", population_percent: 1.3},
    "de" => %{population_percent: 9},
    "en" => %{official_status: "official", population_percent: 98},
    "es" => %{population_percent: 8},
    "fr" => %{population_percent: 23},
    "ga" => %{official_status: "official_regional", population_percent: 0.15},
    "gd" => %{
      official_status: "official_regional",
      population_percent: 0.11,
      writing_percent: 5
    },
    "gu" => %{population_percent: 2.9},
    "it" => %{population_percent: 0.2},
    "kw" => %{population_percent: 0.003},
    "lt" => %{population_percent: 0.2},
    "pa" => %{population_percent: 3.6},
    "pl" => %{population_percent: 4},
    "pt" => %{population_percent: 0.2},
    "sco" => %{population_percent: 2.5, writing_percent: 5},
    "so" => %{population_percent: 0.2},
    "ta" => %{population_percent: 3.2},
    "tr" => %{population_percent: 0.2},
    "ur" => %{population_percent: 3.5},
    "zh-Hant" => %{population_percent: 0.3}
  },
  literacy_percent: 99,
  measurement_system: %{
    default: :uksystem,
    paper_size: :a4,
    temperature: :uksystem
  },
  population: 65761100
}
Link to this function

inverted_subdivisions(atom)

View Source
Link to this function

inverted_territories(atom)

View Source
Link to this function

known_subdivisions(locale \\ TestBackend.Cldr.get_locale())

View Source

Specs

known_subdivisions(Cldr.Territory.atom_binary_tag()) ::
  map() | {:error, Cldr.Territory.error()}

Returns a map of all known territory subdivisions in a given locale.

example

Example

=> TestBackend.Cldr.Territory.known_subdivisions("en")
%{
  "ad02" => "Canillo",
  "ad03" => "Encamp",
  "ad04" => "La Massana",
  "ad05" => "Ordino",
  "ad06" => "Sant JuliΓ  de LΓ²ria",
  "ad07" => "Andorra la Vella",
  ...

iex> TestBackend.Cldr.Territory.known_subdivisions()
%{}

iex> TestBackend.Cldr.Territory.known_subdivisions("zzz")
{:error, {Cldr.InvalidLanguageError, "The language \"zzz\" is invalid"}}
Link to this function

known_territories(locale \\ TestBackend.Cldr.get_locale())

View Source

Specs

known_territories(Cldr.Territory.atom_binary_tag()) ::
  map() | {:error, Cldr.Territory.error()}

Returns a map of all known territories in a given locale.

example

Example

=> TestBackend.Cldr.Territory.known_territories()
%{SN: %{standard: "Senegal"}, "061": %{standard: "Polynesia"},
BH: %{standard: "Bahrain"}, TM: %{standard: "Turkmenistan"},
"009": %{standard: "Oceania"}, CW: %{standard: "CuraΓ§ao"},
FR: %{standard: "France"}, TN: %{standard: "Tunisia"},
FI: %{standard: "Finland"}, BF: %{standard: "Burkina Faso"},
"155": %{standard: "Western Europe"}, GL: %{standard: "Greenland"},
VI: %{standard: "U.S. Virgin Islands"}, ZW: %{standard: "Zimbabwe"},
AR: %{standard: "Argentina"}, SG: %{standard: "Singapore"},
SZ: %{standard: "Swaziland"}, ID: %{standard: "Indonesia"},
NR: %{standard: "Nauru"}, RW: %{standard: "Rwanda"},
TR: %{standard: "Turkey"}, IS: %{standard: "Iceland"},
ME: %{standard: "Montenegro"}, AW: %{standard: "Aruba"},
PY: %{standard: "Paraguay"}, "145": %{standard: "Western Asia"},
CG: %{standard: "Congo - Brazzaville", variant: "Congo (Republic)"},
LT: %{standard: "Lithuania"}, SA: %{standard: "Saudi Arabia"},
MZ: %{standard: "Mozambique"}, NU: %{standard: "Niue"},
NG: %{standard: "Nigeria"}, CK: %{standard: "Cook Islands"},
ZM: %{standard: "Zambia"}, LK: %{standard: "Sri Lanka"},
UY: %{standard: "Uruguay"}, YE: %{standard: "Yemen"},
"011": %{standard: "Western Africa"},
CC: %{standard: "Cocos (Keeling) Islands"}, BY: %{standard: "Belarus"},
IL: %{standard: "Israel"}, KY: %{standard: "Cayman Islands"},
GN: %{standard: "Guinea"}, VN: %{standard: "Vietnam"},
PE: %{standard: "Peru"}, HU: %{standard: "Hungary"},
HN: %{standard: "Honduras"}, GI: %{standard: "Gibraltar"},
"142": %{standard: "Asia"}, "029": %{...}, ...}

=> TestBackend.Cldr.Territory.known_territories("zzz")
{:error, {Cldr.InvalidLanguageError, "The language "zzz" is invalid"}}
Link to this function

known_territory_subdivisions(territory_code)

View Source

Specs

known_territory_subdivisions(Cldr.Territory.atom_binary_tag()) ::
  {:ok, binary()} | {:error, Cldr.Territory.error()}

Returns a list of subdivisions of a given territory.

example

Example

=> TestBackend.Cldr.Territory.known_territory_subdivisions(:GB)
{:ok, ["gbabc", "gbabd", "gbabe", "gbagb", "gbagy", "gband", "gbann",
"gbans", "gbbas", "gbbbd", "gbbdf", "gbbdg", "gbben", "gbbex", "gbbfs",
"gbbge", "gbbgw", "gbbir", "gbbkm", "gbbmh", "gbbne", "gbbnh", "gbbns",
"gbbol", "gbbpl", "gbbrc", "gbbrd", "gbbry", "gbbst", "gbbur", "gbcam",
"gbcay", "gbcbf", "gbccg", "gbcgn", "gbche", "gbchw", "gbcld", "gbclk",
"gbcma", "gbcmd", "gbcmn", "gbcon", "gbcov", "gbcrf", "gbcry", "gbcwy",
"gbdal", "gbdby", "gbden", ...]}

iex> TestBackend.Cldr.Territory.known_territory_subdivisions(:ZZZ)
{:error, {Cldr.UnknownTerritoryError, "The territory :ZZZ is unknown"}}
Link to this function

parent(territory_code, opts \\ [as: :atom])

View Source

Specs

Lists parent(s) for the given territory code. Returns {:ok, list} if successful, otherwise {:error, reason}.

  • options are:
    • as: :atom
    • as: :binary
    • as: :charlist

example

Example

iex> TestBackend.Cldr.Territory.parent(:GB)
{:ok, [:"154", :UN]}

iex> TestBackend.Cldr.Territory.parent(:ZZZ)
{:error, {Cldr.UnknownTerritoryError, "The territory :ZZZ is unknown"}}

iex> TestBackend.Cldr.Territory.parent(Cldr.get_locale())
{:error, {Cldr.UnknownChildrenError, "The territory :\"001\" has no parent(s)"}}
Link to this function

parent!(territory_code, opts \\ [as: :atom])

View Source

Specs

The same as parent/2, but raises an exception if it fails.

  • options are:
    • as: :atom
    • as: :binary
    • as: :charlist

example

Example

iex> TestBackend.Cldr.Territory.parent!(:GB)
[:"154", :UN]
Link to this function

to_currency_code(territory_code, opts \\ [as: :atom])

View Source

Specs

A helper method to get a territory's currency code if a territory has multiply currencies then the oldest active currency is returned. Returns {:ok, code} if successful, otherwise {:error, reason}.

  • options are:
    • as: :atom
    • as: :binary
    • as: :charlist

example

Example

iex> TestBackend.Cldr.Territory.to_currency_code(:US)
{:ok, :USD}

iex> TestBackend.Cldr.Territory.to_currency_code("cu")
{:ok, :CUP}
Link to this function

to_currency_code!(territory_code, opts \\ [as: :atom])

View Source

Specs

The same as to_currency_code/2, but raises an exception if it fails.

  • options are:
    • as: :atom
    • as: :binary
    • as: :charlist

example

Example

iex> TestBackend.Cldr.Territory.to_currency_code!(:US)
:USD

iex> TestBackend.Cldr.Territory.to_currency_code!(:US, as: :charlist)
'USD'

iex> TestBackend.Cldr.Territory.to_currency_code!("PS")
:ILS

iex> TestBackend.Cldr.Territory.to_currency_code!("PS", as: :binary)
"ILS"
Link to this function

to_currency_codes(territory_code, opts \\ [as: :atom])

View Source

Specs

A helper method to get a territory's currency codes. Returns {:ok, list} if successful, otherwise {:error, reason}.

  • options are:
    • as: :atom
    • as: :binary
    • as: :charlist

example

Example

iex> TestBackend.Cldr.Territory.to_currency_codes(:US)
{:ok, [:USD]}

iex> TestBackend.Cldr.Territory.to_currency_codes("cu")
{:ok, [:CUP, :CUC]}
Link to this function

to_currency_codes!(territory_code, opts \\ [as: :atom])

View Source

Specs

The same as to_currency_codes/2, but raises an exception if it fails.

  • options are:
    • as: :atom
    • as: :binary
    • as: :charlist

example

Example

iex> TestBackend.Cldr.Territory.to_currency_codes!(:US)
[:USD]

iex> TestBackend.Cldr.Territory.to_currency_codes!(:US, as: :charlist)
['USD']

iex> TestBackend.Cldr.Territory.to_currency_codes!("PS")
[:ILS, :JOD]

iex> TestBackend.Cldr.Territory.to_currency_codes!("PS", as: :binary)
["ILS", "JOD"]
Link to this function

to_unicode_flag(territory_code)

View Source

Specs

to_unicode_flag(
  Cldr.Territory.atom_binary_tag()
  | {:ok, atom()}
  | {:error, Cldr.Territory.error()}
) :: {:ok, binary()} | {:error, Cldr.Territory.error()}

Unicode flag for the given territory code. Returns {:ok, flag} if successful, otherwise {:error, reason}.

example

Example

iex> TestBackend.Cldr.Territory.to_unicode_flag(:US)
{:ok, "πŸ‡ΊπŸ‡Έ"}

iex> TestBackend.Cldr.Territory.to_unicode_flag(:EZ)
{:error, {Cldr.UnknownFlagError, "The territory :EZ has no flag"}}
Link to this function

to_unicode_flag!(territory_code)

View Source

Specs

to_unicode_flag!(Cldr.Territory.atom_binary_tag()) :: binary() | no_return()

The same as to_unicode_flag/1, but raises an exception if it fails.

example

Example

iex> TestBackend.Cldr.Territory.to_unicode_flag!(:US)
"πŸ‡ΊπŸ‡Έ"
Link to this function

translate_language_tag(from_locale, options \\ [locale: TestBackend.Cldr.get_locale(), style: :standard])

View Source

Specs

translate_language_tag(Cldr.Territory.tag(), Cldr.Territory.options()) ::
  {:ok, binary()} | {:error, Cldr.Territory.error()}

Translate a LanguageTag.t into a localized string from one locale to another. Returns {:ok, result} if successful, otherwise {:error, reason}.

example

Example

iex> TestBackend.Cldr.Territory.translate_language_tag(Cldr.get_locale())
{:ok, "world"}

iex> TestBackend.Cldr.Territory.translate_language_tag(Cldr.get_locale(), [locale: Cldr.Locale.new!("pt", TestBackend.Cldr)])
{:ok, "Mundo"}
Link to this function

translate_language_tag!(locale_from, options \\ [locale: TestBackend.Cldr.get_locale(), style: :standard])

View Source

Specs

translate_language_tag!(Cldr.Territory.tag(), Cldr.Territory.options()) ::
  binary() | no_return()

The same as translate_language_tag/2, but raises an exception if it fails.

example

Example

iex> TestBackend.Cldr.Territory.translate_language_tag!(Cldr.get_locale())
"world"

iex> TestBackend.Cldr.Territory.translate_language_tag!(Cldr.get_locale(), [locale: Cldr.Locale.new!("pt", TestBackend.Cldr)])
"Mundo"
Link to this function

translate_subdivision(localized_string, from_locale, to_locale \\ TestBackend.Cldr.get_locale())

View Source

Specs

translate_subdivision(
  binary(),
  Cldr.Territory.atom_binary_tag(),
  Cldr.Territory.atom_binary_tag()
) :: {:ok, binary()} | {:error, Cldr.Territory.error()}

Translate a localized string from one locale to another. Returns {:ok, result} if successful, otherwise {:error, reason}.

example

Example

iex> TestBackend.Cldr.Territory.translate_subdivision("Cumbria", "en", "pl")
{:ok, "Kumbria"}

iex> TestBackend.Cldr.Territory.translate_subdivision("Cumbria", "en", "bs")
{:error, {Cldr.UnknownSubdivisionError, "The locale :bs has no translation for :gbcma."}}

iex> TestBackend.Cldr.Territory.translate_subdivision("Cumbria", :zzz)
{:error, {Cldr.InvalidLanguageError, "The language \"zzz\" is invalid"}}

iex> TestBackend.Cldr.Territory.translate_subdivision("Cumbria", "en", "zzz")
{:error, {Cldr.InvalidLanguageError, "The language \"zzz\" is invalid"}}
Link to this function

translate_subdivision!(localized_string, from_locale, to_locale \\ TestBackend.Cldr.get_locale())

View Source

Specs

The same as translate_subdivision/3, but raises an exception if it fails.

example

Example

iex> TestBackend.Cldr.Territory.translate_subdivision!("Cumbria", "en", "pl")
"Kumbria"

iex> TestBackend.Cldr.Territory.translate_subdivision!("Kumbria", "pl", "en")
"Cumbria"
Link to this function

translate_territory(localized_string, from_locale)

View Source
Link to this function

translate_territory(localized_string, from_locale, to_locale)

View Source
Link to this function

translate_territory(localized_string, from_locale, to_locale, style)

View Source

Specs

translate_territory(
  binary(),
  Cldr.Territory.atom_binary_tag(),
  Cldr.Territory.atom_binary_tag(),
  atom()
) :: {:ok, binary()} | {:error, Cldr.Territory.error()}

Translate a localized string from one locale to another. Returns {:ok, result} if successful, otherwise {:error, reason}.

example

Example

iex> TestBackend.Cldr.Territory.translate_territory("Reino Unido", "pt")
{:ok, "United Kingdom"}

iex> TestBackend.Cldr.Territory.translate_territory("United Kingdom", "en", "pt")
{:ok, "Reino Unido"}

iex> TestBackend.Cldr.Territory.translate_territory("Reino Unido", :zzz)
{:error, {Cldr.InvalidLanguageError, "The language \"zzz\" is invalid"}}

iex> TestBackend.Cldr.Territory.translate_territory("United Kingdom", "en", "zzz")
{:error, {Cldr.InvalidLanguageError, "The language \"zzz\" is invalid"}}

iex> TestBackend.Cldr.Territory.translate_territory("Westworld", "en", "pt")
{:error, {Cldr.UnknownTerritoryError, "No territory translation for \"Westworld\" could be found in locale :en"}}
Link to this function

translate_territory!(localized_string, from_locale)

View Source
Link to this function

translate_territory!(localized_string, from_locale, to_locale)

View Source
Link to this function

translate_territory!(localized_string, from_locale, to_locale, style)

View Source

Specs

The same as translate_territory/3, but raises an exception if it fails.

example

Example

iex> TestBackend.Cldr.Territory.translate_territory!("Reino Unido", "pt")
"United Kingdom"

iex> TestBackend.Cldr.Territory.translate_territory!("United Kingdom", "en", "pt")
"Reino Unido"

#=> TestBackend.Cldr.Territory.translate_territory!("Westworld", "en", "pt")
** (Cldr.UnknownTerritoryError) No territory translation for "Westworld" could be found in locale "en"