NAME

Locale::Object - OO locale information

VERSION

0.54_01

DESCRIPTION

The Locale::Object group of modules attempts to provide locale-related information in an object-oriented fashion. The information is collated from several sources and provided in an accompanying DBD::SQLite database.

At present, the modules are:

* Locale::Object - make compound objects containing country, currency and language objects

* Locale::Object::Country - objects representing countries

* Locale::Object::Continent - objects representing continents

* Locale::Object::Currency - objects representing currencies

* Locale::Object::Currency::Converter - convert between currencies

* Locale::Object::DB - does lookups for the modules in the database

* Locale::Object::DB::Schemata - documents the database, including all data sources.

* Locale::Object::Language - objects representing languages

For more information, see the documentation for those modules.

SYNOPSIS

    use Locale::Object;
    
    my $obj = Locale::Object->new(
                                  country_code_alpha2  => 'gb',
                                  currency_code        => 'GBP',
                                  language_code_alpha2 => 'en'
                                 );

    $obj->country_code_alpha2('af');
    $obj->country_code_alpha3('afg');

    $obj->currency_code('AFA');
    $obj->currency_code_numeric('004');
    
    $obj->language_code_alpha2('ps');
    $obj->language_code_alpha3('pus');
    $obj->language_name('Pushto');
    

METHODS

new()

    my $obj = Locale::Object->new(
                                  country_code_alpha2  => 'gb',
                                  currency_code        => 'GBP',
                                  language_code_alpha2 => 'en'
                                 );

This documentation is all TBD as of 0.54_01. Stay tuned.

country_code_alpha2(), country_code_alpha3()

country_code(), currency_code_numeric()

language_code_alpha2(), language_code_alpha3(), language_name()

AUTHOR

Earle Martin <EMARTIN@cpan.org>

http://purl.oclc.org/net/earlemartin/

CREDITS

Original concept: Pierre Denis (PDENIS). I had much useful assistance from Pierre, Tom Insam (TOMI) - who contributed to my knowledge of DBI - and James Duncan (JDUNCAN). Most of the OO concepts involved I learnt from Damian Conway (DCONWAY)'s excellent book "Object Oriented Perl" (ISBN 1-884777-79-1).

COPYRIGHT

Copyright 2003 Fotango Ltd. All rights reserved. http://opensource.fotango.com/

This module is released under the same license as Perl itself, and is provided on an "as is" basis. The author and Fotango Ltd make no warranties of any kind, either expressed or implied, as to the accuracy and/or utility of any results obtained from its use. However, if you do find something wrong with the results, please let the author know. Thanks.

SEE ALSO

Locale::Codes, for simple conversions between names and ISO codes.