live 77ˆl–Ým_J¥2ÛR‚œPLÜ×Ò˜´oÏ 0a–Ým_J¥2ÛR‚œPLÜ×Ò˜´oÎ"9ˆl–Ðz¾”*e¶¥² Z¸Ø.JbÑ¿Ñ ƒq׿Ïo9=pod =head1 NAME Locale::Country - standard codes for country identification =head1 SYNOPSIS use Locale::Country; $country = code2country('jp' [,CODESET]); # $country gets 'Japan' $code = country2code('Norway' [,CODESET]); # $code gets 'no' @codes = all_country_codes( [CODESET]); @names = all_country_names(); # semi-private routines Locale::Country::alias_code('uk' => 'gb'); Locale::Country::rename_country('gb' => 'Great Britain'); =head1 DESCRIPTION The C module provides access to several code sets that can be used for identifying countries, such as those defined in ISO 3166-1. Most of the routines take an optional additional argument which specifies the code set to use. If not specified, the default ISO 3166-1 two-letter codes will be used. =head1 SUPPORTED CODE SETS There are several different code sets you can use for identifying countries. A code set may be specified using either a name, or a constant that is automatically exported by this module. For example, the two are equivalent: $country = code2country('jp','alpha-2'); $country = code2country('jp',LOCALE_CODE_ALPHA_2); The codesets currently supported are: =over 4 =item B This is the set of two-letter (lowercase) codes from ISO 3166-1, such as 'tv' for Tuvalu. This is the default code set. =item B This is the set of three-letter (lowercase) codes from ISO 3166-1, such as 'brb' for Barbados. These codes are actually defined and maintained by the U.N. Statistics division. =item B This is the set of three-digit numeric codes from ISO 3166-1, such as 064 for Bhutan. These codes are actually defined and maintained by the U.N. Statistics division. If a 2-digit code is entered, it is converted to 3 digits by prepending a 0. =item B The FIPS 10 data are two-letter (uppercase) codes assigned by the National Geospatial-Intelligence Agency. NOTE: The FIPS-10 document is being withdrawn. It was deprecated in 2008, and is being updated now only until all the agencies that use it have switched to something else. I will continue to support the FIPS-10 codeset as long as it is available, but at the point it is no longer available, support will be withdrawn immediately. If an official end-of-life date is announced, I will include a notice here. Otherwise, support for the codeset will be discontinued when the document is withdrawn. You are encouraged to no longer use the FIPS-10 codeset. =item B The IANA is responsible for delegating management of the top level country domains. The country domains are the two-letter (lowercase) codes from ISO 3166 with a few other additions. =back =head1 ROUTINES =over 4 =item B =item B =item B =item B =item B =item B =item B =item B =item B =item B =item B =item B =item B These routines are all documented in the Locale::Codes::API man page. =item B Version 2.07 included 2 functions for modifying the internal data: rename_country and alias_code. Both of these could be used only to modify the internal data for country codes. As of 3.10, the internal data for all types of codes can b