/Users/cpanrun/depot/main/contrib-patched/perl/CPAN/src/Locale-SubCountry/blib/html/site/lib/Locale/SubCountry.html

/Users/cpanrun/depot/main/contrib-patched/perl/CPAN/src/Locale-SubCountry/blib/html/site/lib/Locale/SubCountry.html

regional_division</pre> Given a sub country object, the <code>regional_division</code> method takes the ISO 3166-2 code of a sub country and returns the sub country's regionional_division. This is, an alphanumeric code. The regional_division is returned as a capitalised string, or "unknown" if no match is found. <h2><a name=``has_sub_countries''>has_sub_countries</a></h2> Given a sub country object, the <code>has_sub_countries</code> method returns 1 if the current country has sub countries, or 0 if it does not. Some small countires such as Singapore do not have sub countries. <h2><a name=``fips10_4_code''>FIPS10_4_code</a></h2> Given a sub country object, the <code>FIPS_10_4_code</code> method takes the ISO 3166-2 code of a sub country and returns the sub country's FIPS 10-4 code, or the string 'unknown', if none exists. FIPS is a standard developed by the US government. <h2><a name=``iso3166_2_code''>ISO3166_2_code</a></h2> Given a sub country object, the <code>ISO3166_2_code</code> method takes the FIPS 10-4 code of a sub country and returns the sub country's ISO 3166-2 code, or the string 'unknown', if none exists. <h2><a name=``full_name_code_hash__for_subcountry_objects_''>full_name_code_hash (for subcountry objects)</a></h2> Given a sub country object, returns a hash of all full name/code pairs, keyed by sub country name. If the country has no sub countries, returns undef. <h2><a name=``code_full_name_hash__for_subcountry_objects_''>code_full_name_hash (for subcountry objects)</a></h2> Given a sub country object, returns a hash of all code/full name pairs, keyed by sub country code. If the country has no sub countries, returns undef. <h2><a name=``all_full_names__for_subcountry_objects_''>all_full_names (for subcountry objects)</a></h2> Given a sub country object, returns an array of all sub country full names, sorted alphabetically. If the country has no sub countries, returns undef. <h2><a name=``all_codes__for_subcountry_objects_''>all_codes (for subcountry objects)</a></h2> Given a sub country object, returns an array of all sub country ISO 3166-2 codes, sorted alphabetically. If the country has no sub countries, returns undef. <hr /> <h1><a name=``see_also''>SEE ALSO</a></h1> ISO 3166-1:1997 Codes for the representation of names of countries and their subdivisions - Part 1: Country codes ISO 3166-2:1998 Codes for the representation of names of countries and their subdivisions - Part 2: Country subdivision code Also released as AS/NZS 2632.2:1999 Federal Information Processing Standards Publication 10-4 1995 April Specifications for COUNTRIES, DEPENDENCIES, AREAS OF SPECIAL SOVEREIGNTY, AND THEIR PRINCIPAL ADMINISTRATIVE DIVISION/p <a href=``http://www.statoids.com/statoids.html''>http://www.statoids.com/statoids.html <a href=``../../../lib/Locale/Country.html''>the Locale::Country manpage</a>,<a href=``../../../Lingua/EN/AddressParse.html''>the Lingua::EN::AddressParse manpage</a>, <a href=``../../../site/lib/Geo/StreetAddress/US.html''>the Geo::StreetAddress::US manpage</a><a href=``../../../Geo/PostalAddress.html''>the Geo::PostalAddress manpage</a><a href=``../../../Geo/IP.html''>the Geo::IP manpage</a> <hr /> <h1><a name=``limitations''>LIMITATION/a</h1> ISO 3166-2:1998 defines all sub country codes as being up to 3 letters and/or numbers. These codes are commonly accepted for countries like the USA and Canada. In Australia this method of abbreviation is not widely accepted. For example, the ISO code for 'New South Wales' is 'NS', but 'NSW' is the abbreviation that is most commonly used. I could add a flag to enforce ISO-3166-2 codes if needed. The ISO 3166-2 standard romanizes the names of provinces and regions in non-latin script areas, such as Russia and South Korea. One Romanisation is given for each province name. For Russia, the BGN (1947) Romanization is used. Several sub country names have more than one code, and may not return the correct code for that sub country. These entries are usually duplicated because the name represents two different types of sub country, such as a province and a geographical unit. Examples are: <pre> AZERBAIJAN : spanänkäran; LA (the City), LAN (the Rayon) AZERBAIJAN : /spanäki; SA,SAK AZERBAIJAN : Susa; S/span,SU/span AZERBAIJAN : Yevlax; Y&Y;/span>,YEV INDONESIA : Kalimantan Timur; K/span,KT LAO/span : Vientiane V/span,VT MOLDOVA : Hahul; CA,CHspan MOLDOVA : Bubasari; DU,DB/span MOLDOVA : Hrhei; OR,OH/span MOLDOVA : Coroca; SO,SOA MOLDOVA : Gngheni; UN,UG/span MOZAMBIQU&MOZAMBIQU;/span> : Maputo; MPM,span </pre> FIPS codes are not provided for all sub countries. <hr /> <h1><a name=``bugs''>BUG/a</h1> None known <hr /> <h1><a name=``author''>AUTHOR</a></h1> Locale::SubCountry was written by Kim Ryan <kimryan at cpan dot org>. <hr /> <h1><a name=``credits''>CREDIT/a</h1> Alastair McKinstry provided many of the sub country codes and names. Terrence Brannon produced Locale::US, which was the starting point for this module. Mark Summerfield and Guy Fraser provided the list of UK counties. TJ Mather supplied the FIPS codes and many ammendments to the sub country data <hr /> <h1><a name=``copyright_and_license''>COPYRIGHT AND LICENS©RIGHT AND LICENS;/a></h1> Copyright (c) 2006 Kim Ryan. All rights reserved. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.4 or, at your option, any later version of Perl 5 you may have available.

</body>

</html>

/Users/cpanrun/depot/main/contrib-patched/perl/CPAN/src/Locale-SubCountry/blib/html/site/lib/Locale/SubCountry.html