Locale::Object::Language 0.75

Locale::Object::Language Perl module contains language information objects.

Locale::Object::Language allows you to create objects containing information about languages such as their ISO codes, the countries theyre used in and so on.

SYNOPSIS

use Locale::Object::Language;

my $eng = Locale::Object::Language->new( code_alpha3 => eng );

my $name = $eng->name;
my $code_alpha2 = $eng->code_alpha2;
my $code_alpha3 = $eng->code_alpha3;

my @countries = $eng->countries;

my $gb = Locale::Object::Country->new( code_alpha2 => gb );

print $eng->official($gb);

METHODS

new()

my $eng = Locale::Object::Language->new( code_alpha3 => eng );

The new method creates an object. It takes a single-item hash as an argument - valid options to pass are ISO 3166 values - code_alpha2, code_alpha3 and name (see Locale::Object::DB::Schemata for details on these).
The objects created are singletons; if you try and create a currency object when one matching your specification already exists, new() will return the original one.

name(), code_alpha2(), code_alpha3()

my $name = $country->name;

These methods retrieve the values of the attributes in the object whose name they share.

countries()

my @countries = $eng->countries;

Returns an array (in array context, otherwise a reference) of Locale::Object::Country objects with their ISO 3166 alpha2 codes as keys (see Locale::Object::DB::Schemata for more details on those) for all countries using this currency in array context, or a reference in scalar context. The objects have their own attribute methods, so you can do things like this for example:

foreach my $place (@countries)
{
print $place->name, "n";
}

Which will list you all the countries that use in that currency. See the documentation for Locale::Object::Country for a listing of country attributes. Note that you can chain methods as well.

foreach my $place (@countries)
{
print $place->continent->name, "n";
}
official()
my $gb = Locale::Object::Country->new( code_alpha2 => gb );

print $eng->official($gb); # prints true

Give this method a Locale::Object::Country object, and it will return a true or false value for whether the country the object represents has the language represented by your Locale::Object::Language object as an official language. See database.pod for a note about languages in the database.