Module:ISO 3166/sandbox
![]() | This is the module sandbox page for Module:ISO 3166 (diff). See also the companion subpage for test cases (run). |
![]() | This module is rated as ready for general use. It has reached a mature form and is thought to be relatively bug-free and ready for use wherever appropriate. It is ready to mention on help pages and other Wikipedia resources as an option for new users to learn. To reduce server load and bad output, it should be improved by sandbox testing rather than repeated trial-and-error editing. |
![]() | This module is subject to page protection. It is a highly visible module in use by a very large number of pages, or is substituted very frequently. Because vandalism or mistakes would affect many pages, and even trivial editing might cause substantial load on the servers, it is protected from editing. |
![]() | This Lua module is used on 1,090,000+ pages, or roughly 2% of all pages. To avoid major disruption and server load, any changes should be tested in the module's /sandbox or /testcases subpages, or in your own module sandbox. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. |
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 name
, as well as to code
(which can therefore also be used to convert between different code types). Use |codetype=
to output alpha-3 or numeric codes in code
instead of the default alpha-2 codes.
Name
To get the common name use the name function
{{#invoke:ISO 3166|name|GB}}
→ United Kingdom{{#invoke:ISO 3166|name|GBR}}
→ United Kingdom{{#invoke:ISO 3166|name|826}}
→ United Kingdom
ISO Name
To get the ISO name use the name function with isoname = yes
{{#invoke:ISO 3166|name|GB|isoname=yes}}
→ United Kingdom of Great Britain and Northern Ireland{{#invoke:ISO 3166|name|GBR|isoname=yes}}
→ United Kingdom of Great Britain and Northern Ireland{{#invoke:ISO 3166|name|826|isoname=yes}}
→ United Kingdom of Great Britain and Northern Ireland
Alpha-2
To get the alpha 2 code use the code function
{{#invoke:ISO 3166|code|826}}
→ GB{{#invoke:ISO 3166|code|United Kingdom}}
→ GB{{#invoke:ISO 3166|code|UK}}
→ GB
Alpha-3
To get the alpha 3 code use the code function with codetype = 3
{{#invoke:ISO 3166|code|United Kingdom|codetype=alpha3}}
→ GBR{{#invoke:ISO 3166|name|GB}}
→ United Kingdom{{#invoke:ISO 3166|name|GBR}}
→ United Kingdom{{#invoke:ISO 3166|name|826}}
→ United Kingdom{{#invoke:ISO 3166|code|UK|codetype=alpha3}}
→ GBR
Numeric
To get the numeric code use the code function with codetype = numeric or use the numeric function
{{#invoke:ISO 3166|numeric|GB}}
→ 826{{#invoke:ISO 3166|code|GB|codetype=numeric}}
→ 826
Subdivisions (ISO 3166-2)
Inputs to name
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
, 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
{{#invoke:ISO 3166|code|United Kingdom|England}}
→ GB-ENG{{#invoke:ISO 3166|code|GBR|England}}
→ GB-ENG{{#invoke:ISO 3166|code|GB|England}}
→ GB-ENG
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
{{#invoke:ISO 3166|name|GB-ENG}}
→ England{{#invoke:ISO 3166|name|GB|ENG}}
→ England
|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 |lang=
to a 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 data page.
{{#invoke:ISO 3166|name|BE|BRU}}
→ Brussels{{#invoke:ISO 3166|name|BE|BRU|isoname=yes}}
→ Bruxelles-Capitale, Région de{{#invoke:ISO 3166|name|BE|BRU|lang=fr}}
→ Bruxelles-Capitale, Région de{{#invoke:ISO 3166|name|BE|BRU|lang=nl}}
→ Brussels Hoofdstedelijk Gewest
Tracking categories
- Category:Wikipedia page with obscure country (51)
- Category:Wikipedia page with obscure country or subdivision (2)
- Category:Wikipedia page with obscure subdivision (2,470)
See also
- Wikipedia:Templates for discussion/Log/2015 November 12#Template:ISO 3166 name DE-HB – discussion of replacement of template-based system with Lua
- Wikipedia:Templates_for_discussion/Log/2018_September_10#Template:ISO_3166_code-3_AD – discussion of full removal of template-based system
- {{ISO 3166 name}} – (ISO name)
- {{Country name}} – (Standard name)
- {{ISO 3166 code}} – (Code)
- {{ISO 3166 code-3}} – (3 letter code)
- {{ISO 3166 numeric}} – (numeric code)
- Module:ISO 3166/data – the data subpages used by this module
Subpages
- ISO 3166/data
- ISO 3166/data/AD
- ISO 3166/data/AE
- ISO 3166/data/AF
- ISO 3166/data/AG
- ISO 3166/data/AI
- ISO 3166/data/AL
- ISO 3166/data/AM
- ISO 3166/data/AO
- ISO 3166/data/AQ
- ISO 3166/data/AR
- ISO 3166/data/AS
- ISO 3166/data/AT
- ISO 3166/data/AU
- ISO 3166/data/AW
- ISO 3166/data/AX
- ISO 3166/data/AZ
- ISO 3166/data/BA
- ISO 3166/data/BB
- ISO 3166/data/BD
- ISO 3166/data/BE
- ISO 3166/data/BF
- ISO 3166/data/BG
- ISO 3166/data/BH
- ISO 3166/data/BI
- ISO 3166/data/BJ
- ISO 3166/data/BL
- ISO 3166/data/BM
- ISO 3166/data/BN
- ISO 3166/data/BO
- ISO 3166/data/BQ
- ISO 3166/data/BR
- ISO 3166/data/BS
- ISO 3166/data/BT
- ISO 3166/data/BV
- ISO 3166/data/BW
- ISO 3166/data/BY
- ISO 3166/data/BZ
- ISO 3166/data/CA
- ISO 3166/data/CA/sandbox
- ISO 3166/data/CC
- ISO 3166/data/CD
- ISO 3166/data/CF
- ISO 3166/data/CG
- ISO 3166/data/CH
- ISO 3166/data/CI
- ISO 3166/data/CK
- ISO 3166/data/CL
- ISO 3166/data/CM
- ISO 3166/data/CN
- ISO 3166/data/CO
- ISO 3166/data/CR
- ISO 3166/data/CU
- ISO 3166/data/CV
- ISO 3166/data/CW
- ISO 3166/data/CX
- ISO 3166/data/CY
- ISO 3166/data/CZ
- ISO 3166/data/DE
- ISO 3166/data/DJ
- ISO 3166/data/DK
- ISO 3166/data/DM
- ISO 3166/data/DO
- ISO 3166/data/DZ
- ISO 3166/data/EC
- ISO 3166/data/EE
- ISO 3166/data/EG
- ISO 3166/data/EH
- ISO 3166/data/ER
- ISO 3166/data/ES
- ISO 3166/data/ET
- ISO 3166/data/FI
- ISO 3166/data/FJ
- ISO 3166/data/FK
- ISO 3166/data/FM
- ISO 3166/data/FO
- ISO 3166/data/FR
- ISO 3166/data/GA
- ISO 3166/data/GB
- ISO 3166/data/GB/sandbox
- ISO 3166/data/GD
- ISO 3166/data/GE
- ISO 3166/data/GF
- ISO 3166/data/GG
- ISO 3166/data/GH
- ISO 3166/data/GI
- ISO 3166/data/GL
- ISO 3166/data/GM
- ISO 3166/data/GN
- ISO 3166/data/GN/sandbox
- ISO 3166/data/GP
- ISO 3166/data/GQ
- ISO 3166/data/GR
- ISO 3166/data/GS
- ISO 3166/data/GT
- ISO 3166/data/GU
- ISO 3166/data/GW
- ISO 3166/data/GY
- ISO 3166/data/HK
- ISO 3166/data/HM
- ISO 3166/data/HN
- ISO 3166/data/HR
- ISO 3166/data/HT
- ISO 3166/data/HU
- ISO 3166/data/ID
- ISO 3166/data/IE
- ISO 3166/data/IL
- ISO 3166/data/IM
- ISO 3166/data/IN
- ISO 3166/data/IO
- ISO 3166/data/IQ
- ISO 3166/data/IR
- ISO 3166/data/IS
- ISO 3166/data/IT
- ISO 3166/data/JE
- ISO 3166/data/JM
- ISO 3166/data/JO
- ISO 3166/data/JP
- ISO 3166/data/KE
- ISO 3166/data/KG
- ISO 3166/data/KH
- ISO 3166/data/KI
- ISO 3166/data/KM
- ISO 3166/data/KN
- ISO 3166/data/KP
- ISO 3166/data/KR
- ISO 3166/data/KW
- ISO 3166/data/KY
- ISO 3166/data/KZ
- ISO 3166/data/LA
- ISO 3166/data/LB
- ISO 3166/data/LC
- ISO 3166/data/LI
- ISO 3166/data/LK
- ISO 3166/data/LR
- ISO 3166/data/LS
- ISO 3166/data/LT
- ISO 3166/data/LU
- ISO 3166/data/LV
- ISO 3166/data/LY
- ISO 3166/data/MA
- ISO 3166/data/MC
- ISO 3166/data/MD
- ISO 3166/data/ME
- ISO 3166/data/MF
- ISO 3166/data/MG
- ISO 3166/data/MH
- ISO 3166/data/MK
- ISO 3166/data/ML
- ISO 3166/data/MM
- ISO 3166/data/MN
- ISO 3166/data/MO
- ISO 3166/data/MP
- ISO 3166/data/MQ
- ISO 3166/data/MR
- ISO 3166/data/MS
- ISO 3166/data/MT
- ISO 3166/data/MU
- ISO 3166/data/MV
- ISO 3166/data/MW
- ISO 3166/data/MX
- ISO 3166/data/MY
- ISO 3166/data/MZ
- ISO 3166/data/NA
- ISO 3166/data/NC
- ISO 3166/data/NE
- ISO 3166/data/NF
- ISO 3166/data/NG
- ISO 3166/data/NI
- ISO 3166/data/NL
- ISO 3166/data/NO
- ISO 3166/data/NP
- ISO 3166/data/NR
- ISO 3166/data/NU
- ISO 3166/data/NZ
local p = {}
local data = mw.loadData("Module:ISO 3166/data/National")
local catnocountry = '[[Category:Wikipedia page with obscure country]]'
local catnosubdivision = '[[Category:Wikipedia page with obscure subdivision]]'
--[[----------S T R I P----------]]--
local function strip(text)
local accents = {
["À"]="A", ["Á"]="A", ["Â"]="A", ["Ã"]="A", ["Ä"]="A", ["Å"]="A",
["Ç"]="C",
["È"]="E", ["É"]="E", ["Ê"]="E", ["Ë"]="E",
["Ì"]="I", ["Í"]="I", ["Î"]="I", ["Ï"]="I",
["Ñ"]="N",
["Ò"]="O", ["Ó"]="O", ["Ô"]="O", ["Õ"]="O", ["Ö"]="O", ["Ø"]="O",
["Ù"]="U", ["Ú"]="U", ["Û"]="U", ["Ü"]="U",
["Ý"]="Y"
}
local remove = {
" STATE ",
"%d+PX",
"<.*>",
".+:",
"|.+",
"%(.-%)",
"%..*",
"^THE",
"UNIQ.*QINU",
"%W",
"NATIONOF",
"COUNTRYOF",
"TERRITORYOF",
"FLAGOF",
"FLAG",
"KINGDOMOF",
"STATEOF",
"PROVINCEOF",
"PROVINCE",
"TERRITORY"
}
local patterns = {
["%_"]=" ",
["%-"]=" "
}
text = mw.ustring.upper(text)
-- Case insensitivity
text = mw.ustring.gsub(text,"[À-Ý]",accents)
-- Deaccent
text = mw.text.unstrip(text)
-- Remove markers
for find, replace in pairs(patterns) do
-- Follow gsub patterns
text = mw.ustring.gsub(text,find,replace)
end
for _, find in ipairs(remove) do
-- Remove unneeded text
text = mw.ustring.gsub(text,find,"")
end
return text
end
--[[----------F I N D N A M E----------]]--
-- Checks if the input is in the current table entry (key and value)
local function findname(code,cdata,qry)
local sqry = strip(qry)
if sqry == code
or sqry == cdata["alpha3"]
or sqry == cdata["numeric"]
or sqry == strip(cdata["isoname"] or '')
or sqry == strip(cdata["name"] or '')
then
return true
end
for _,tname in pairs(cdata["isonames"] or {}) do
if sqry == strip(tname) then
return true
end
end
for _,tname in pairs(cdata["altnames"] or {}) do
if sqry == strip(tname) then
return true
end
end
return false
end
--[[----------I S O N A M E----------]]--
-- Find the ISO name of a country/region
local function isoname(data,ldata,lang)
lang = lang or ldata["defaultlang"] or data["defaultlang"] or "en"
return ldata["isonames"] and ldata["isonames"][lang] or ldata["isoname"] or ''
end
--[[----------G E T C O D E---------]]--
-- Makes the ISO code of a country
local function getcode(args)
catnocountry = args.nocat == 'true' and '' or catnocountry
catnosubdivision = args.nocat == 'true' and '' or catnosubdivision
if not args[1] then return catnocountry end
if string.find(args[1], "^%s*(%w%w?%w?)%-(%w%w?%w?)") then
args[1], args[2] = string.match(args[1],"^%s*(%w%w?%w?)%-(%w%w?%w?)")
end
if args[1] then args[1] = strip(args[1]) end
if args[2] then args[2] = strip(args[2]) end
if args["codetype"] == "3" then args["codetype"] = "alpha3" end
--3166-1 code
if not args[2] then
for alpha2,cdata in pairs(data) do
if findname(alpha2,cdata,args[1]) then
if args.type == "numeric" or args.type == "alpha3" then
return cdata[args.type]
elseif args.type == "name" then
if args.isoname or args.lang then
return isoname(data,cdata,args.lang)
end
return cdata["name"]
end
return alpha2
end
end
return catnocountry
--3166-2 code
else
for alpha2,cdata in pairs(data) do
if findname(alpha2,cdata,args[1]) then
-- For England, Wales etc.
if mw.ustring.match(alpha2,"GB") then
alpha2 = "GB"
end
local scdata = mw.loadData("Module:ISO 3166/data/"..alpha2)
for scode,sdata in pairs(scdata) do
if type(sdata)=="table" then
if findname(scode,sdata,args[2]) then
if args.type == "name" then
if args.isoname or args.lang then
return isoname(scdata,sdata,args.lang)
end
return cdata["name"]
else
return alpha2.."-"..scode
end
end
end
end
return catnosubdivision
end
end
return catnocountry
end
end
--[[----------M A K E F U N C---------]]--
local function makefunc(params)
params = params or {}
return function(frame)
local args = {}
if type(frame.args) == 'table' then
args = frame.args
elseif type(frame) == 'table' then
args = frame
end
if params.type then
args.type = params.type
end
if params.func == 'strip' then
return strip(args[1] or args.text)
else
return getcode(args)
end
end
end
--[[----------E X P O R T E D F U N C T I O N S---------]]--
p.strip = makefunc({func='strip'})
p.code = makefunc()
p['alpha2'] = makefunc()
p['alpha3'] = makefunc({type='alpha3'})
p.numeric = makefunc({type='numeric'})
p.name = makefunc({type='name'})
--[[----------P . G E O C O O R D I N S E R T---------]]--
-- Wrapper for Module:Coordinates.coordinsert
function p.geocoordinsert(frame)
-- {{#invoke:ISO 3166|geocoordinsert|{{coord|...}}
-- |country=..|subdivision1=...|subdivision2=...
-- |type=...|scale=...|dim=...|source=...|globe=...
-- }}
local args = frame.args
local subdivisionqueried = false
catnocountry = args.nocat == 'true' and '' or catnocountry
catnosubdivision = args.nocat == 'true' and '' or catnosubdivision
local tracking = ''
local targs = {}
targs[1] = args[1] or ''
for i, v in pairs(args) do
if i == 'country' and not mw.ustring.find(targs[1], 'region:') then
local country = v
local k, region = 1, ''
-- look for a valid subdivision
while region == '' and k < 3 do
local subdivision = args['subdivision' .. k] or ''
if subdivision ~= '' then
region = p.luacode({country, subdivision, nocat = 'true'})
subdivisionqueried = true
end
k = k + 1
end
-- subdivision lookup failed or never attempted, try country only
if region == '' then
region = p.luacode({country, nocat = 'true'})
if region == '' then
tracking = tracking .. catnocountry
elseif subdivisionqueried == true then
tracking = tracking .. catnosubdivision
end
end
-- something worked, add it to the targs
if region ~= '' then
targs[#targs + 1] = 'region:' .. region
end
elseif i == 'type' or i == 'scale' or i == 'dim'
or i == 'source' or i == 'globe' then
targs[#targs + 1] = i .. ':' .. v
end
end
-- call Module:Coordinates.coordinsert if there is something to insert
if #targs > 1 then
local coordinsert = require('Module:Coordinates').coordinsert
return coordinsert({args = targs}) .. tracking
end
-- otherwise, just return the coordinates
return targs[1] .. tracking
end
return p