Locale::Country - module for dealing with country code sets

NAME

Locale::Country - module for dealing with country code sets

SYNOPSIS

   use Locale::Country;

   $name = code2country(CODE);
   $code = country2code(NAME);

   @codes   = all_country_codes();
   @names   = all_country_names();

DESCRIPTION

This module provides access to country code sets.

Please refer to the the Locale::Codes::Types manpage document for a description of the code sets available.

Most of the routines take an optional additional argument which specifies the code set to use. The code set can be specified using the name of a code set, or the perl constant specified in the above document. If not specified, the default code set will be used.

ROUTINES

All routines in this module call the appropriate method in the the Locale::Codes manpage module, using an object of type: country Please refer to the documentation of the the Locale::Codes manpage module for details about each function.

The following functions are exported automatically:

code2country(CODE [,CODESET] [,'retired']): See code2name in the Locale::Codes manpage
country2code(NAME [,CODESET] [,'retired']): See name2code in the Locale::Codes manpage
country_code2code(CODE ,CODESET ,CODESET2): See code2code in the Locale::Codes manpage
all_country_codes([CODESET] [,'retired']): See all_codes in the Locale::Codes manpage
all_country_names([CODESET] [,'retired']): See all_names in the Locale::Codes manpage

The following functions are not exported and must be called fully qualified with the package name:

Locale::Country::show_errors(FLAG): By default, invalid input will produce empty results, but no errors. By passing in a non-zero value of FLAG, errors will be produced.; See show_errors in the Locale::Codes manpage but note that the default for the non-OO modules are to NOT produce errors.
Locale::Country::rename_country(CODE ,NEW_NAME [,CODESET]): See rename_code in the Locale::Codes manpage
Locale::Country::add_country(CODE ,NAME [,CODESET]): See add_code in the Locale::Codes manpage
Locale::Country::delete_country(CODE [,CODESET]): See delete_code in the Locale::Codes manpage
Locale::Country::add_country_alias(NAME ,NEW_NAME): See add_alias in the Locale::Codes manpage
Locale::Country::delete_country_alias(NAME): See delete_alias in the Locale::Codes manpage
Locale::Country::rename_country_code(CODE ,NEW_CODE [,CODESET]): See replace_code in the Locale::Codes manpage
Locale::Country::add_country_code_alias(CODE ,NEW_CODE [,CODESET]): See add_code_alias in the Locale::Codes manpage
Locale::Country::delete_country_code_alias(CODE [,CODESET]): See delete_code_alias in the Locale::Codes manpage

AUTHOR

See Locale::Codes for full author history.

Currently maintained by Sullivan Beck (sbeck@cpan.org)

COPYRIGHT

   Copyright (c) 2011-2019 Sullivan Beck

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.