/ 
Lingua-Postcodes-0.005
River stage zero No dependents
/ Lingua::Postcodes

NAME

Lingua::Postcodes - Returns the names of postcodes/zipcodes

VERSION

version 0.005

SYNOPSIS

use Lingua::Postcodes;

print 'The English name of a postcode in the UK is:', Lingua::Postcodes::name('GB');
# The English name of a postcode in the UK is Postcode

print 'The English name of a postcode in Japan is:', Lingua::Postcodes::name('JP', 'EN');
# The English name of a postcode in Japan is Postal code

print 'The Japanese name of a postcode in Japan is:', Lingua::Postcodes::name('JP', 'JP');
# The Japanese name of a postcode in Japan is 郵便番号

# Alternate usage:

use Ligua::Postcodes 'name';
print 'The Japanese name of a postcode in Japan is:', name('JP', 'JP');
# The Japanese name of a postcode in Japan is 郵便番号

# Unknown postcodes/systems
print 'No postal code system for this country' if Lingua::Postcodes::name('ZZZZZZ') eq undef;
print 'We do not have the translation' if Lingua::Postcodes::name('GB', 'FR') eq 'undef';

DESCRIPTION

This module allows the easy translation of the name of postcodes (postal codes/ zip codes).

Specifically it has been written to give the English name for post codes in other countries. When working on a multi-national website, where address information is required, this module helps the developer to put the correct term in the label of a HTML form to match the nation. For example, when handling the various names for postcodes across Europe.

This module does not parse or handle postcodes themselves; it simply provides a programmatic way of getting the correct name for postcodes for nations.

Reference for if/what a postcode is called in mainly referencing: https://en.wikipedia.org/wiki/List_of_postal_codes

NAME

Lingua::Postcodes - Provide names for postcodes/zipcodes

VERSION

version 0.005

AUTHOR

Lance Wicks <lancew@cpan.org>

LICENSE AND COPYRIGHT

Copyright (c) 2016, Lance Wicks. All rights reserved.

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

AUTHOR

Lance Wicks <lancew@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 by Lance Wicks.

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