Locale::Country(3)

🌍 NAME 🌍

Locale::Country(3) — the module for dealing with country code sets, and yes bestie it's giving exactly what it says on the tin 💅

✨ SYNOPSIS ✨

use Locale::Country;

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

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

🦋 DESCRIPTION 🦋

Okay so this module provides access to country code sets. That's the whole assignment. 🫶

Please refer to the Locale::Codes::Types document for a description of the code sets available. It's the doc you wanna peek at, no cap.

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. Lowkey convenient, highkey iconic.

💅 ROUTINES 💅

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

🎀 The following functions are exported automatically 🎀

• code2country(CODE [,CODESET] [,'retired']) — see code2name in Locale::Codes.
• code2countrys(CODE [,CODESET]) — see code2names in Locale::Codes.
• country2code(NAME [,CODESET] [,'retired']) — see name2code in Locale::Codes.
• country_code2code(CODE ,CODESET ,CODESET2) — see code2code in Locale::Codes.
• all_country_codes([CODESET] [,'retired']) — see all_codes in Locale::Codes.
• all_country_names([CODESET] [,'retired']) — see all_names in Locale::Codes.

🔒 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 Locale::Codes 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 Locale::Codes.
• Locale::Country::add_country(CODE ,NAME [,CODESET]) — see add_code in Locale::Codes.
• Locale::Country::delete_country(CODE [,CODESET]) — see delete_code in Locale::Codes.
• Locale::Country::add_country_alias(NAME ,NEW_NAME) — see add_alias in Locale::Codes.
• Locale::Country::delete_country_alias(NAME) — see delete_alias in Locale::Codes.
• Locale::Country::rename_country_code(CODE ,NEW_CODE [,CODESET]) — see replace_code in Locale::Codes.
• Locale::Country::add_country_code_alias(CODE ,NEW_CODE [,CODESET]) — see add_code_alias in Locale::Codes.
• Locale::Country::delete_country_code_alias(CODE [,CODESET]) — see delete_code_alias in Locale::Codes.

👀 SEE ALSO 👀

• Locale::Codes — The Locale-Codes distribution. Go look, bestie 🫶

🌸 AUTHOR 🌸

See Locale::Codes for full author history.

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

🎀 COPYRIGHT 🎀

Copyright (c) 2011-2024 Sullivan Beck

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

---

💖 That's a wrap on perl v5.42.0, dated 2024-06-23, and this iconic little page is Locale::Country(3). Periodt. 🫶