Initial commit of OpenSPARC T2 design and verification files.
[OpenSPARC-T2-DV] / tools / perl-5.8.0 / lib / 5.8.0 / Locale / Country.pm
CommitLineData
86530b38
AT
1#
2# Locale::Country - ISO codes for country identification (ISO 3166)
3#
4# $Id: Country.pm,v 2.6 2002/07/10 16:33:27 neilb Exp $
5#
6
7package Locale::Country;
8use strict;
9require 5.002;
10
11require Exporter;
12use Carp;
13use Locale::Constants;
14
15
16#-----------------------------------------------------------------------
17# Public Global Variables
18#-----------------------------------------------------------------------
19use vars qw($VERSION @ISA @EXPORT @EXPORT_OK);
20$VERSION = sprintf("%d.%02d", q$Revision: 2.6 $ =~ /(\d+)\.(\d+)/);
21@ISA = qw(Exporter);
22@EXPORT = qw(code2country country2code
23 all_country_codes all_country_names
24 country_code2code
25 LOCALE_CODE_ALPHA_2 LOCALE_CODE_ALPHA_3 LOCALE_CODE_NUMERIC);
26
27#-----------------------------------------------------------------------
28# Private Global Variables
29#-----------------------------------------------------------------------
30my $CODES = [];
31my $COUNTRIES = [];
32
33
34#=======================================================================
35#
36# code2country ( CODE [, CODESET ] )
37#
38#=======================================================================
39sub code2country
40{
41 my $code = shift;
42 my $codeset = @_ > 0 ? shift : LOCALE_CODE_DEFAULT;
43
44
45 return undef unless defined $code;
46
47 #-------------------------------------------------------------------
48 # Make sure the code is in the right form before we use it
49 # to look up the corresponding country.
50 # We have to sprintf because the codes are given as 3-digits,
51 # with leading 0's. Eg 052 for Barbados.
52 #-------------------------------------------------------------------
53 if ($codeset == LOCALE_CODE_NUMERIC)
54 {
55 return undef if ($code =~ /\D/);
56 $code = sprintf("%.3d", $code);
57 }
58 else
59 {
60 $code = lc($code);
61 }
62
63 if (exists $CODES->[$codeset]->{$code})
64 {
65 return $CODES->[$codeset]->{$code};
66 }
67 else
68 {
69 #---------------------------------------------------------------
70 # no such country code!
71 #---------------------------------------------------------------
72 return undef;
73 }
74}
75
76
77#=======================================================================
78#
79# country2code ( NAME [, CODESET ] )
80#
81#=======================================================================
82sub country2code
83{
84 my $country = shift;
85 my $codeset = @_ > 0 ? shift : LOCALE_CODE_DEFAULT;
86
87
88 return undef unless defined $country;
89 $country = lc($country);
90 if (exists $COUNTRIES->[$codeset]->{$country})
91 {
92 return $COUNTRIES->[$codeset]->{$country};
93 }
94 else
95 {
96 #---------------------------------------------------------------
97 # no such country!
98 #---------------------------------------------------------------
99 return undef;
100 }
101}
102
103
104#=======================================================================
105#
106# country_code2code ( NAME [, CODESET ] )
107#
108#=======================================================================
109sub country_code2code
110{
111 (@_ == 3) or croak "country_code2code() takes 3 arguments!";
112
113 my $code = shift;
114 my $inset = shift;
115 my $outset = shift;
116 my $outcode;
117 my $country;
118
119
120 return undef if $inset == $outset;
121 $country = code2country($code, $inset);
122 return undef if not defined $country;
123 $outcode = country2code($country, $outset);
124 return $outcode;
125}
126
127
128#=======================================================================
129#
130# all_country_codes ( [ CODESET ] )
131#
132#=======================================================================
133sub all_country_codes
134{
135 my $codeset = @_ > 0 ? shift : LOCALE_CODE_DEFAULT;
136
137 return keys %{ $CODES->[$codeset] };
138}
139
140
141#=======================================================================
142#
143# all_country_names ( [ CODESET ] )
144#
145#=======================================================================
146sub all_country_names
147{
148 my $codeset = @_ > 0 ? shift : LOCALE_CODE_DEFAULT;
149
150 return values %{ $CODES->[$codeset] };
151}
152
153
154#=======================================================================
155#
156# alias_code ( ALIAS => CODE [ , CODESET ] )
157#
158# Add an alias for an existing code. If the CODESET isn't specified,
159# then we use the default (currently the alpha-2 codeset).
160#
161# Locale::Country::alias_code('uk' => 'gb');
162#
163#=======================================================================
164sub alias_code
165{
166 my $alias = shift;
167 my $real = shift;
168 my $codeset = @_ > 0 ? shift : LOCALE_CODE_DEFAULT;
169
170 my $country;
171
172
173 if (not exists $CODES->[$codeset]->{$real})
174 {
175 carp "attempt to alias \"$alias\" to unknown country code \"$real\"\n";
176 return undef;
177 }
178 $country = $CODES->[$codeset]->{$real};
179 $CODES->[$codeset]->{$alias} = $country;
180 $COUNTRIES->[$codeset]->{"\L$country"} = $alias;
181
182 return $alias;
183}
184
185# old name of function for backwards compatibility
186*_alias_code = *alias_code;
187
188
189#=======================================================================
190#
191# rename_country
192#
193# change the official name for a country, eg:
194# gb => 'Great Britain'
195# rather than the standard 'United Kingdom'. The original is retained
196# as an alias, but the new name will be returned if you lookup the
197# name from code.
198#
199#=======================================================================
200sub rename_country
201{
202 my $code = shift;
203 my $new_name = shift;
204 my $codeset = @_ > 0 ? shift : _code2codeset($code);
205 my $country;
206 my $c;
207
208
209 if (not defined $codeset)
210 {
211 carp "rename_country(): unknown country code \"$code\"\n";
212 return 0;
213 }
214
215 $country = $CODES->[$codeset]->{$code};
216
217 foreach my $cset (LOCALE_CODE_ALPHA_2,
218 LOCALE_CODE_ALPHA_3,
219 LOCALE_CODE_NUMERIC)
220 {
221 if ($cset == $codeset)
222 {
223 $c = $code;
224 }
225 else
226 {
227 $c = country_code2code($code, $codeset, $cset);
228 }
229
230 $CODES->[$cset]->{$c} = $new_name;
231 $COUNTRIES->[$cset]->{"\L$new_name"} = $c;
232 }
233
234 return 1;
235}
236
237
238#=======================================================================
239#
240# _code2codeset
241#
242# given a country code in an unknown codeset, return the codeset
243# it is from, or undef.
244#
245#=======================================================================
246sub _code2codeset
247{
248 my $code = shift;
249
250
251 foreach my $codeset (LOCALE_CODE_ALPHA_2, LOCALE_CODE_ALPHA_3,
252 LOCALE_CODE_NUMERIC)
253 {
254 return $codeset if (exists $CODES->[$codeset]->{$code})
255 }
256
257 return undef;
258}
259
260
261#=======================================================================
262#
263# initialisation code - stuff the DATA into the ALPHA2 hash
264#
265#=======================================================================
266{
267 my ($alpha2, $alpha3, $numeric);
268 my ($country, @countries);
269
270
271 while (<DATA>)
272 {
273 next unless /\S/;
274 chop;
275 ($alpha2, $alpha3, $numeric, @countries) = split(/:/, $_);
276
277 $CODES->[LOCALE_CODE_ALPHA_2]->{$alpha2} = $countries[0];
278 foreach $country (@countries)
279 {
280 $COUNTRIES->[LOCALE_CODE_ALPHA_2]->{"\L$country"} = $alpha2;
281 }
282
283 if ($alpha3)
284 {
285 $CODES->[LOCALE_CODE_ALPHA_3]->{$alpha3} = $countries[0];
286 foreach $country (@countries)
287 {
288 $COUNTRIES->[LOCALE_CODE_ALPHA_3]->{"\L$country"} = $alpha3;
289 }
290 }
291
292 if ($numeric)
293 {
294 $CODES->[LOCALE_CODE_NUMERIC]->{$numeric} = $countries[0];
295 foreach $country (@countries)
296 {
297 $COUNTRIES->[LOCALE_CODE_NUMERIC]->{"\L$country"} = $numeric;
298 }
299 }
300
301 }
302
303 close(DATA);
304}
305
3061;
307
308__DATA__
309ad:and:020:Andorra
310ae:are:784:United Arab Emirates
311af:afg:004:Afghanistan
312ag:atg:028:Antigua and Barbuda
313ai:aia:660:Anguilla
314al:alb:008:Albania
315am:arm:051:Armenia
316an:ant:530:Netherlands Antilles
317ao:ago:024:Angola
318aq:ata:010:Antarctica
319ar:arg:032:Argentina
320as:asm:016:American Samoa
321at:aut:040:Austria
322au:aus:036:Australia
323aw:abw:533:Aruba
324az:aze:031:Azerbaijan
325ba:bih:070:Bosnia and Herzegovina
326bb:brb:052:Barbados
327bd:bgd:050:Bangladesh
328be:bel:056:Belgium
329bf:bfa:854:Burkina Faso
330bg:bgr:100:Bulgaria
331bh:bhr:048:Bahrain
332bi:bdi:108:Burundi
333bj:ben:204:Benin
334bm:bmu:060:Bermuda
335bn:brn:096:Brunei Darussalam
336bo:bol:068:Bolivia
337br:bra:076:Brazil
338bs:bhs:044:Bahamas
339bt:btn:064:Bhutan
340bv:bvt:074:Bouvet Island
341bw:bwa:072:Botswana
342by:blr:112:Belarus
343bz:blz:084:Belize
344ca:can:124:Canada
345cc:cck:166:Cocos (Keeling) Islands
346cf:caf:140:Central African Republic
347cg:cog:178:Congo:Congo, Republic of the
348ch:che:756:Switzerland
349ci:civ:384:Cote D'Ivoire
350ck:cok:184:Cook Islands
351cl:chl:152:Chile
352cm:cmr:120:Cameroon
353cn:chn:156:China
354co:col:170:Colombia
355cr:cri:188:Costa Rica
356cu:cub:192:Cuba
357cv:cpv:132:Cape Verde
358cx:cxr:162:Christmas Island
359cy:cyp:196:Cyprus
360cz:cze:203:Czech Republic
361de:deu:276:Germany
362dj:dji:262:Djibouti
363dk:dnk:208:Denmark
364dm:dma:212:Dominica
365do:dom:214:Dominican Republic
366dz:dza:012:Algeria
367ec:ecu:218:Ecuador
368ee:est:233:Estonia
369eg:egy:818:Egypt
370eh:esh:732:Western Sahara
371er:eri:232:Eritrea
372es:esp:724:Spain
373et:eth:231:Ethiopia
374fi:fin:246:Finland
375fj:fji:242:Fiji
376fk:flk:238:Falkland Islands (Malvinas):Falkland Islands (Islas Malvinas)
377fm:fsm:583:Micronesia, Federated States of
378fo:fro:234:Faroe Islands
379fr:fra:250:France
380fx:fxx:249:France, Metropolitan
381ga:gab:266:Gabon
382gb:gbr:826:United Kingdom:Great Britain
383gd:grd:308:Grenada
384ge:geo:268:Georgia
385gf:guf:254:French Guiana
386gh:gha:288:Ghana
387gi:gib:292:Gibraltar
388gl:grl:304:Greenland
389gm:gmb:270:Gambia
390gn:gin:324:Guinea
391gp:glp:312:Guadeloupe
392gq:gnq:226:Equatorial Guinea
393gr:grc:300:Greece
394gs:sgs:239:South Georgia and the South Sandwich Islands
395gt:gtm:320:Guatemala
396gu:gum:316:Guam
397gw:gnb:624:Guinea-Bissau
398gy:guy:328:Guyana
399hk:hkg:344:Hong Kong
400hm:hmd:334:Heard Island and McDonald Islands
401hn:hnd:340:Honduras
402hr:hrv:191:Croatia
403ht:hti:332:Haiti
404hu:hun:348:Hungary
405id:idn:360:Indonesia
406ie:irl:372:Ireland
407il:isr:376:Israel
408in:ind:356:India
409io:iot:086:British Indian Ocean Territory
410iq:irq:368:Iraq
411ir:irn:364:Iran, Islamic Republic of:Iran
412is:isl:352:Iceland
413it:ita:380:Italy
414jm:jam:388:Jamaica
415jo:jor:400:Jordan
416jp:jpn:392:Japan
417ke:ken:404:Kenya
418kg:kgz:417:Kyrgyzstan
419kh:khm:116:Cambodia
420ki:kir:296:Kiribati
421km:com:174:Comoros
422kn:kna:659:Saint Kitts and Nevis
423kp:prk:408:Korea, Democratic People's Republic of:Korea, North:North Korea
424kr:kor:410:Korea, Republic of:Korea, South:South Korea
425kw:kwt:414:Kuwait
426ky:cym:136:Cayman Islands
427kz:kaz:398:Kazakhstan:Kazakstan
428la:lao:418:Lao People's Democratic Republic
429lb:lbn:422:Lebanon
430lc:lca:662:Saint Lucia
431li:lie:438:Liechtenstein
432lk:lka:144:Sri Lanka
433lr:lbr:430:Liberia
434ls:lso:426:Lesotho
435lt:ltu:440:Lithuania
436lu:lux:442:Luxembourg
437lv:lva:428:Latvia
438ly:lby:434:Libyan Arab Jamahiriya:Libya
439ma:mar:504:Morocco
440mc:mco:492:Monaco
441md:mda:498:Moldova, Republic of:Moldova
442mg:mdg:450:Madagascar
443mh:mhl:584:Marshall Islands
444mk:mkd:807:Macedonia, the Former Yugoslav Republic of:Macedonia, Former Yugoslav Republic of:Macedonia
445ml:mli:466:Mali
446mm:mmr:104:Myanmar
447mn:mng:496:Mongolia
448mo:mac:446:Macao:Macau
449mp:mnp:580:Northern Mariana Islands
450mq:mtq:474:Martinique
451mr:mrt:478:Mauritania
452ms:msr:500:Montserrat
453mt:mlt:470:Malta
454mu:mus:480:Mauritius
455mv:mdv:462:Maldives
456mw:mwi:454:Malawi
457mx:mex:484:Mexico
458my:mys:458:Malaysia
459mz:moz:508:Mozambique
460na:nam:516:Namibia
461nc:ncl:540:New Caledonia
462ne:ner:562:Niger
463nf:nfk:574:Norfolk Island
464ng:nga:566:Nigeria
465ni:nic:558:Nicaragua
466nl:nld:528:Netherlands
467no:nor:578:Norway
468np:npl:524:Nepal
469nr:nru:520:Nauru
470nu:niu:570:Niue
471nz:nzl:554:New Zealand
472om:omn:512:Oman
473pa:pan:591:Panama
474pe:per:604:Peru
475pf:pyf:258:French Polynesia
476pg:png:598:Papua New Guinea
477ph:phl:608:Philippines
478pk:pak:586:Pakistan
479pl:pol:616:Poland
480pm:spm:666:Saint Pierre and Miquelon
481pn:pcn:612:Pitcairn:Pitcairn Island
482pr:pri:630:Puerto Rico
483ps:pse:275:Palestinian Territory, Occupied
484pt:prt:620:Portugal
485pw:plw:585:Palau
486py:pry:600:Paraguay
487qa:qat:634:Qatar
488re:reu:638:Reunion
489ro:rom:642:Romania
490ru:rus:643:Russian Federation:Russia
491rw:rwa:646:Rwanda
492sa:sau:682:Saudi Arabia
493sb:slb:090:Solomon Islands
494sc:syc:690:Seychelles
495sd:sdn:736:Sudan
496se:swe:752:Sweden
497sg:sgp:702:Singapore
498sh:shn:654:Saint Helena
499si:svn:705:Slovenia
500sj:sjm:744:Svalbard and Jan Mayen:Jan Mayen:Svalbard
501sk:svk:703:Slovakia
502sl:sle:694:Sierra Leone
503sm:smr:674:San Marino
504sn:sen:686:Senegal
505so:som:706:Somalia
506sr:sur:740:Suriname
507st:stp:678:Sao Tome and Principe
508sv:slv:222:El Salvador
509sy:syr:760:Syrian Arab Republic:Syria
510sz:swz:748:Swaziland
511tc:tca:796:Turks and Caicos Islands
512td:tcd:148:Chad
513tf:atf:260:French Southern Territories
514tg:tgo:768:Togo
515th:tha:764:Thailand
516tj:tjk:762:Tajikistan
517tk:tkl:772:Tokelau
518tm:tkm:795:Turkmenistan
519tn:tun:788:Tunisia
520to:ton:776:Tonga
521tl:tls:626:East Timor
522tr:tur:792:Turkey
523tt:tto:780:Trinidad and Tobago
524tv:tuv:798:Tuvalu
525tw:twn:158:Taiwan, Province of China:Taiwan
526tz:tza:834:Tanzania, United Republic of:Tanzania
527ua:ukr:804:Ukraine
528ug:uga:800:Uganda
529um:umi:581:United States Minor Outlying Islands
530us:usa:840:United States:USA:United States of America
531uy:ury:858:Uruguay
532uz:uzb:860:Uzbekistan
533va:vat:336:Holy See (Vatican City State):Holy See (Vatican City)
534vc:vct:670:Saint Vincent and the Grenadines
535ve:ven:862:Venezuela
536vg:vgb:092:Virgin Islands, British:British Virgin Islands
537vi:vir:850:Virgin Islands, U.S.
538vn:vnm:704:Vietnam
539vu:vut:548:Vanuatu
540wf:wlf:876:Wallis and Futuna
541ws:wsm:882:Samoa
542ye:yem:887:Yemen
543yt:myt:175:Mayotte
544yu:yug:891:Yugoslavia
545za:zaf:710:South Africa
546zm:zmb:894:Zambia
547zr:zar:180:Zaire:Congo, The Democratic Republic of the:Congo, Democratic Republic of the
548zw:zwe:716:Zimbabwe