1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
# iso
[](https://travis-ci.org/Locale/iso)
This project is a ruby implementation of ISO 639-1 alpha2 and ISO 3166-1. It includes definitions of all two letter language and region codes.
## Languages
Languages are defined by **ISO 639-1 alpha-2**; that is the 2 letter lowercase language code.
These have been augmented to contain the plural rule names and the language's direction.
> ISO::Language.find('ru')
=> #<ISO::Language:0x007fe2ba43db50
@plural_rule_names=["one", "few", "many", "other"],
@direction="ltr",
@code="ru",
@name="Russian">
## Regions
Regions are defined by **ISO 3166-1**; that is the 2 letter uppercase region code.
> ISO::Region.find('MX')
=> #<ISO::Region:0x007fe2ba070e50
@code="MX",
@name="Mexico">
Regions can also be defined by the **UN M49** standard; that is the 3 digit region code.
> ISO::UN::Region.find('419')
=> #<ISO::Region:0x007fe2ba43db50
@code="419",
@name="Latin America and the Caribbean">
## Tags
The combination of a language and a region is called a Tag :
> ISO::Tag.new('pt-BR')
=> #<ISO::Tag:0x007fe2bb005b90 @code="pt-BR",
@language=#<ISO::Language:0x007fe2ba256918
@plural_rule_names=["one", "other"],
@direction="ltr",
@code="pt",
@name="Portuguese">,
@region=#<ISO::Region:0x007fe2ba412e28
@code="BR",
@name="Brazil">>
You can check if a Tag is valid like so :
> ISO::Tag.new('pt-BR').valid? => true
> ISO::Tag.new('lolcat').valid? => false
## I18n
Language and region names are internationalized - [contribute to the I18n project directly on Locale](http://www.localeapp.com/projects/1763) for any changes.
|
