[−][src]Module simple_locale::codes
Parent to a set of standard code/identifier lookup modules.
These modules are effectively registries of standard code/identifiers and any metadate published as a part of the associated standard(s). For example, Codes for the representation of currencies, or ISO 4217 is based on a spreadsheet published directly by ISO itself with some additional fields added from other publicly accessible sources.
While there is no formal type system or traits for modules exporting codes, there are definitely some patterns all of the current implementations follow.
- modules typically implement a
lookup()
function that returns anOption
, - although where some standards have both alphabetic and numeric identifiers
there are
lookup_by_alpha()
andlookup_by_numeric()
instead, . - Most will also include a function
all_codes()
to retrieve a vector of all the known identifiers, - or,
all_alpha_codes()
andall_numeric_codes()
as appropriate.
Some standards, specifically language and country, support 2-character and
3-character alphabetic identifiers, a single lookup()
function is used to
lookup either.
Modules
codeset | Character sets registered with IANA. |
country | Codes for the representation of names of countries and their subdivisions. |
currency | Codes for the representation of currencies. |
language | Codes for the representation of names of languages. |
region | Codes for the representation of names of countries and their subdivisions. |
script | Codes for the representation of names of scripts |