View source for Module:ISO 3166/doc

{{Module rating|p}}
{{High risk|493000+}}

This module returns a country's or subdivision's code (alpha-2, alpha-3, numeric) or name (ISO, non-ISO) from [[ISO 3166]] from a variety of inputs (alpha-2, alpha-3, numeric, name, ISO-name, alternative names). The module also removes junk from the input.
==Examples==
===Countries (ISO 3166-1)===
All three types of [[ISO 3166-1]] codes (alpha-2, alpha-3 and numeric) work as inputs to <code>name</code>, as well as to <code>code</code> (which can therefore also be used to convert between different code types). Use {{para|codetype}} to output alpha-3 or numeric codes in <code>code</code> instead of the default alpha-2 codes.
====Name====
To get the common name use the name function
*{{tnull|&#35;invoke:ISO 3166|name|GB}} &rarr; {{#invoke:ISO 3166|name|GB}}
*{{tnull|&#35;invoke:ISO 3166|name|GBR}} &rarr; {{#invoke:ISO 3166|name|GBR}}
*{{tnull|&#35;invoke:ISO 3166|name|826}} &rarr; {{#invoke:ISO 3166|name|826}}
====ISO Name====
To get the common name use the name function with isoname = yes
*{{tnull|&#35;invoke:ISO 3166|name|GB|isoname{{=}}yes}} &rarr; {{#invoke:ISO 3166|name|GB|isoname=yes}}
*{{tnull|&#35;invoke:ISO 3166|name|GBR|isoname{{=}}yes}} &rarr; {{#invoke:ISO 3166|name|GBR|isoname=yes}}
*{{tnull|&#35;invoke:ISO 3166|name|826|isoname{{=}}yes}} &rarr; {{#invoke:ISO 3166|name|826|isoname=yes}}
====Alpha-2====
To get the alpha 2 code use the code function
*{{tnull|&#35;invoke:ISO 3166|code|826}} &rarr; {{#invoke:ISO 3166|code|826}}
*{{tnull|&#35;invoke:ISO 3166|code|United Kingdom}} &rarr; {{#invoke:ISO 3166|code|United Kingdom}}
*{{tnull|&#35;invoke:ISO 3166|code|UK}} &rarr; {{#invoke:ISO 3166|code|UK}}
====Alpha-3====
To get the alpha 3 code use the code function with codetype = 3
*{{tnull|&#35;invoke:ISO 3166|code|United Kingdom|codetype{{=}}alpha3}} &rarr; {{#invoke:ISO 3166|code|United Kingdom|codetype=alpha3}}
*{{tnull|&#35;invoke:ISO 3166|name|GB}} &rarr; {{#invoke:ISO 3166|name|GB}}
*{{tnull|&#35;invoke:ISO 3166|name|GBR}} &rarr; {{#invoke:ISO 3166|name|GBR}}
*{{tnull|&#35;invoke:ISO 3166|name|826}} &rarr; {{#invoke:ISO 3166|name|826}}
*{{tnull|&#35;invoke:ISO 3166|code|UK|codetype{{=}}alpha3}} &rarr; {{#invoke:ISO 3166|code|UK|codetype=alpha3}}
====Numeric====
To get the numeric code use the code function with codetype = numeric '''or''' use the numeric function
*{{tnull|&#35;invoke:ISO 3166|numeric|GB}} &rarr; {{#invoke:ISO 3166|numeric|GB}}
*{{tnull|&#35;invoke:ISO 3166|code|GB|codetype{{=}}numeric}} &rarr; {{#invoke:ISO 3166|code|GB|codetype=numeric}}
===Subdivisions (ISO 3166-2)===
Inputs to <code>name</code> must be valid [[ISO 3166-2]] codes, i.e. the country's alpha-2 code for the first part, and up to three alphanumeric characters for the second part. They may be given normally (with a hyphen between the parts), or split between two unnamed parameters. For <code>code</code>, the first parameter is the country name (or any of its three codes, like above), and the second the subdivision name.
====Code (alpha-2)====
To get the alpha-2 code of a subdivision use the code function with parameter 1 being the country and parameter 2 being the subdivision
*{{tnull|&#35;invoke:ISO 3166|code|United Kingdom|England}} &rarr; {{#invoke:ISO 3166|code|United Kingdom|England}}
*{{tnull|&#35;invoke:ISO 3166|code|GBR|England}} &rarr; {{#invoke:ISO 3166|code|GBR|England}}
*{{tnull|&#35;invoke:ISO 3166|code|GB|England}} &rarr; {{#invoke:ISO 3166|code|GB|England}}
====Name====
To get the name of a subdivision use the name function with parameter 1 being the country and parameter 2 being the subdivsion '''or''' parameter 1 being the subdivsion code
*{{tnull|&#35;invoke:ISO 3166|name|GB-ENG}} &rarr; {{#invoke:ISO 3166|name|GB-ENG}}
*{{tnull|&#35;invoke:ISO 3166|name|GB|ENG}} &rarr; {{#invoke:ISO 3166|name|GB|ENG}}

{{para|isoname}} works for subnational entities as well; keep in mind that ISO 3166-2 uses (transliterations of) local names that may differ from English ones. Set {{para|lang}} to a [[ISO 639|language code]] to switch between different languages for entities that have multiple ISO names. The default language for multilingual entities can be set on the country's [[Module:ISO 3166/data|data page]].
*{{tnull|&#35;invoke:ISO 3166|name|BE|BRU}} &rarr; {{#invoke:ISO 3166|name|BE|BRU}}
*{{tnull|&#35;invoke:ISO 3166|name|BE|BRU|isoname{{=}}yes}} &rarr; {{#invoke:ISO 3166|name|BE|BRU|isoname=yes}}
*{{tnull|&#35;invoke:ISO 3166|name|BE|BRU|lang{{=}}fr}} &rarr; {{#invoke:ISO 3166|name|BE|BRU|lang=fr}}
*{{tnull|&#35;invoke:ISO 3166|name|BE|BRU|lang{{=}}nl}} &rarr; {{#invoke:ISO 3166|name|BE|BRU|lang=nl}}

== Tracking categories ==
* {{clc|Wikipedia page with obscure country}}
* {{clc|Wikipedia page with obscure country or subdivision}}
* {{clc|Wikipedia page with obscure subdivision}}
==See also==
*[[Wikipedia:Templates for discussion/Log/2015 November 12#Template:ISO 3166 name DE-HB]] &ndash; discussion of replacement of [[Template:ISO 3166 conversion template doc|template-based system]] with Lua
*[[Wikipedia:Templates_for_discussion/Log/2018_September_10#Template:ISO_3166_code-3_AD]] &ndash; discussion of full removal of [[Template:ISO 3166 conversion template doc|template-based system]]
*{{tl|ISO 3166 name}} &ndash; (ISO name)
*{{tl|Country name}} &ndash; (Standard name)
*{{tl|ISO 3166 code}} &ndash; (Code)
*{{tl|ISO 3166 code-3}} &ndash; (3 letter code)
*{{tl|ISO 3166 numeric}} &ndash; (numeric code)
*[[Module:ISO 3166/data]] &ndash; the data subpages used by this module

==Subpages==
{{Special:Prefixindex/Module:ISO 3166/}}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
[[Category:Data retrieval templates]]
}}</includeonly>