View source for Template:ISO 3166 conversion template doc

{{Lua|Module:ISO 3166}}

This template is part of a series that resolves the country and subdivision names to [[ISO 3166-1]] and [[ISO 3166-2]] codes, and vice versa. {{#ifeq:{{Str len|{{{3|}}}}}|2|See also: [[ISO 3166-2:{{{3}}}]]}} ISO 3166 defines names, two and three letter codes and code numbers for all countries and six character codes (the two letter country code followed by a dash and a two or three character subdivision code) for all top level subdivisions. 

==Templates==
===ISO 3166-1===
* ISO 3166-1 alpha-2: {{Tl|ISO 3166 code}} (''e.g.'', {{ISO 3166 code|Iran}})
* ISO 3166-1 alpha-3: {{Tl|ISO 3166 code-3}} (''e.g.'', {{ISO 3166 code-3|Iran}})
* ISO 3166-1 numeric: {{Tl|ISO 3166 numeric}} (''e.g.'', {{ISO 3166 numeric|Iran}})

===ISO 3166-2===
* ISO 3166-2: {{Tl|ISO 3166 code}} (''e.g.'', {{ISO 3166 code|Iran|Alborz}})
* ISO 3166-2 name: {{Tl|ISO 3166 name}} (''e.g.'', {{ISO 3166 name|Iran}})

===Non-ISO 3166===
Country name: {{Tl|Country name}} (''e.g.'', {{Country name|Iran}})

==Usage==
When we wish to convert between various identifiers that may loosely be defined as ''user input'' and ISO 3166 entities, there may be more than one way to do each conversion. For our examples we use [[Pakistan]] as the country and [[Balochistan (Pakistan)]] as the subdivision.

The ISO-3166 identifiers for Pakistan are:
* Name: Pakistan
* Alpha-2 code: PK
* Alpha-3 code: PAK
* Numeric code: 586

The ISO-3166 identifiers for Balochistan (Pakistan) is:
* Subdivision code:PK-BK

Now Pakistan also has a number of synonyms, for example, Pakistán and پاکستان.

Similarly Baluchistan is known, for example, as [[Balochistan]] (on Wikipedia) and [[Bagh Sanjari]].

=== Finding the Alpha-2 code ===
Any of the country identifiers can be used.

* {{Tlx|ISO 3166 code|Pakistan}} PK
* {{Tlx|ISO 3166 code|PK}} PK
* {{Tlx|ISO 3166 code|PAK}} PK
* {{Tlx|ISO 3166 code|586}} PK
* {{Tlx|ISO 3166 code|Pakistán}} PK
* {{Tlx|ISO 3166 code|پاکستان}} PK

=== Finding the Alpha-3 code ===

* {{Tlx|ISO 3166 code-3|Pakistan}} PAK
* {{Tlx|ISO 3166 code-3|PK}} PAK
* {{Tlx|ISO 3166 code-3|PAK}} PAK
* {{Tlx|ISO 3166 code-3|586}} PAK
* {{Tlx|ISO 3166 code-3|Pakistán}} PAK
* {{Tlx|ISO 3166 code-3|پاکستان}} PAK

=== Finding the name of a country ===

* {{Tlx|ISO 3166 name|Pakistan}} Pakistan
* {{Tlx|ISO 3166 name|PK}} Pakistan
* {{Tlx|ISO 3166 name|PAK}} Pakistan
* {{Tlx|ISO 3166 name|586}} Pakistan
* {{Tlx|ISO 3166 name|Pakistán}} Pakistan
* {{Tlx|ISO 3166 name|پاکستان}} Pakistan

=== Finding the common name of a country ===

* {{Tlx|Country name|Pakistan}} Pakistan
* {{Tlx|Country name|PK}} Pakistan
* {{Tlx|Country name|PAK}} Pakistan
* {{Tlx|Country name|586}} Pakistan
* {{Tlx|Country name|Pakistán}} Pakistan
* {{Tlx|Country name|پاکستان}} Pakistan
* {{Tlx|Country name|Mughal Empire}}
* {{Tlx|Country name|Mughal Empire|notfound<nowiki>={{error|Country not found}}</nowiki>}} {{error|Country not found}}
* {{Tlx|Country name|Mughal Empire|notfound<nowiki>=</nowiki>Mughal Empire}} Mughal Empire

=== Finding the numeric code of a country ===

* {{Tlx|ISO 3166 numeric|Pakistan}} 586
* {{Tlx|ISO 3166 numeric|PK}} 586
* {{Tlx|ISO 3166 numeric|PAK}} 586
* {{Tlx|ISO 3166 numeric|586}} 586
* {{Tlx|ISO 3166 numeric|Pakistán}} 586

=== Finding the subdivision code ===

* {{Tlx|ISO 3166 code|Pakistan|Baluchistan}} PK-BA
* {{Tlx|ISO 3166 code|Pakistan|Balochistan}} PK-BA
* {{Tlx|ISO 3166 code|Pakistan|Bagh Sanjari}} PK-BA
* {{Tlx|ISO 3166 code|Pakistán|Baluchistan}} PK-BA
* {{Tlx|ISO 3166 code|Paquistán|Balochistan}} PK-BA
* {{Tlx|ISO 3166 code|PK|Baluchistan}} PK-BA

<includeonly>{{Sandbox other||
[[Category:ISO 3166 templates]]
[[Category:Data retrieval templates]]
}}</includeonly><noinclude>
{{Documentation}}
</noinclude>