NAME

       NCC::CountryCode - Perl extension for blah blah blah

SYNOPSIS

         use NCC::CountryCode;

         my $cc = new NCC::CountryCode();

         my $cc_hash = $cc->getCCs();

         print ($cc->isCC('NL')) ? "exists" : "non-existing";

         $cc->CC2Country('fr');

         $cc->Country2CC('russia');

DESCRIPTION

       This module provides class and several methods to simplify mapping between country names
       and country codes, as they assigned in the ISO3166.

       The CC2Country() method maps country code to the corresponding country name or empty
       string, if it doesn\'t exist.

       The Country2CC() tries to map passed country name into country code. As the spelling of
       the name may vary, this function tries to find all possible matches for passed name. In
       array context method returns hash of country codes and names, in scalar - a string,
       containing all possible country codes and corresponding country names.

       The isCC() method verifies, that passed country code is a legal one and returns it in
       upper case. Otherwise it returns empty string.

       The getCCs() method returns the reference to the internal hash, that contains all the
       country codes with corresponding them country names.

BUGS

       In addition to the country codes defined by ISO3166 standard this module also introduce
       'UK' as a synonim for 'GB' and 'EU' as additional 'virtual' name for the Europe itself.

AUTHOR

       Timur Bakeyev, timur@ripe.net

SEE ALSO

       perl(1).