codes-iso-3166 0.1.5

This package contains an implementation of the ISO 3166 Country Codes specification.
Documentation 
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

/*!
Codes for the representation of names of countries and their subdivisions –
Part 1: Country codes, defines codes for the names of countries, dependent
territories, and special areas of geographical interest.

The standard employs a code of letters and numbers to represent the name of a
given geographical area in order to save time and energy when describing the
area, as well as to reduce the risk of description errors. The official name
of the standard is Codes for the representation of names of countries and
their subdivisions.

# Alpha-2 Codes

SO 3166-1 alpha-2 codes are two-letter country codes defined in ISO 3166-1,
part of the ISO 3166 standard published by the International Organization
for Standardization (ISO), to represent countries, dependent territories, and
special areas of geographical interest. They are the most widely used of the
country codes published by ISO (the others being alpha-3 and numeric), and are
used most prominently for the Internet's country code top-level domains (with
a few exceptions). They are also used as country identifiers extending the
postal code when appropriate within the international postal system for paper
mail, and have replaced the previous one consisting one-letter codes. They
were first included as part of the ISO 3166 standard in its first edition in
1974.

# Alpha-3 Codes

ISO 3166-1 alpha-3 codes are three-letter country codes defined in ISO 3166-1,
part of the ISO 3166 standard published by the International Organization for
Standardization (ISO), to represent countries, dependent territories, and
special areas of geographical interest. They allow a better visual association
between the codes and the country names than the two-letter alpha-2 codes (the
third set of codes is numeric and hence offers no visual association). They
were first included as part of the ISO 3166 standard in its first edition in
1974.

# Numeric Codes

ISO 3166-1 numeric (or numeric-3) codes are three-digit country codes defined
in ISO 3166-1, part of the ISO 3166 standard published by the International
Organization for Standardization (ISO), to represent countries, dependent
territories, and special areas of geographical interest. They are similar to
the three-digit country codes developed and maintained by the United Nations
Statistics Division, from which they originate in its UN M.49 standard. They
were first included as part of the ISO 3166 standard in its second edition in
1981, but they were released by the United Nations Statistics Division since
as early as 1970.

An advantage of numeric codes over alphabetic codes is script (writing system)
independence. The ISO 3166-1 alphabetic codes (alpha-2 and alpha-3) use
letters from the 26-letter English alphabet and are suitable for languages
based on the Latin alphabet. For people and systems using non-Latin scripts
(such as Arabic or Japanese), the English alphabet may be unavailable or
difficult to use, understand, or correctly interpret. While numeric codes
overcome the problems of script dependence, this independence comes at the
cost of loss of mnemonic convenience.

# Properties

The following table demonstrates the set of properties available on the part-1
`CountryCode` type. Note that where a code has been reused, that is it has an
active record *and* a former record, then the details of the former are
included. Where a full name is not included it is safe to assume that the short
name may be used as such.

|                         | AG                  | ID                        | SK                  |
| ----------------------- | ------------------- | ------------------------- | ------------------- |
| **alpha-2 code**        | AG                  | ID                        | SK                  |
| **short name**          | Antigua and Barbuda | Indonesia                 | Slovakia            |
| alpha-3 code            | ATG                 | IDN                       | SVK                 |
| numeric code            | 028                 | 360                       | 703                 |
| independent             | true                | true                      | true                |
| status                  | Assigned            | Assigned                  | Assigned            |
| full name               |                     | the Republic of Indonesia | the Slovak Republic |
| languages               | Eng, Fra            | Eng, Fra, Ind             | Eng, Fra, Slk       |
| administrative language | Eng                 | Ind                       | Slk                 |
| former alpha-3 code     |                     |                           | SKM                 |
| former short name       |                     |                           | Sikkim              |

*/

// ------------------------------------------------------------------------------------------------
//
// The rest of this file is generated by the package build script.
//
// ------------------------------------------------------------------------------------------------

include!(concat!(env!("OUT_DIR"), "/part_1.rs"));

// ------------------------------------------------------------------------------------------------
// Modules
// ------------------------------------------------------------------------------------------------

#[cfg(feature = "status")]
#[doc(hidden)]
mod status;
#[cfg(feature = "status")]
pub use status::Status;

#[cfg(feature = "indices")]
pub mod indices;