debian man page for locale::us

Locale::US(3pm) 					User Contributed Perl Documentation					   Locale::US(3pm)

NAME
       Locale::US - two letter codes for state identification in the United States and vice versa.

SYNOPSIS
	 use Locale::US;

	 my $u = Locale::US->new;

	 my $state = $u->{code2state}{$code};
	 my $code  = $u->{state2code}{$state};

	 my @state = $u->all_state_names;
	 my @code  = $u->all_state_codes;

ABSTRACT
       Map from US two-letter codes to states and vice versa.

DESCRIPTION
   MAPPING
       $self->{code2state}

       This is a hashref which has two-letter state names as the key and the long name as the value.

       $self->{state2code}

       This is a hashref which has the long nameas the key and the two-letter state name as the value.

   DUMPING
       $self->all_state_names

       Returns an array (not arrayref) of all state names in alphabetical form

       $self->all_state_codes

       Returns an array (not arrayref) of all state codes in alphabetical form.

KNOWN BUGS AND LIMITATIONS
       o   The state name is returned in "uc()" format.

       o   neither hash is strict, though they should be.

SEE ALSO
   Locale::Country
       Locale::Country

   Abbreviations
       <http://www.usps.gov/ncsc/lookups/usps_abbreviations.htm>

	   Online file with the USPS two-letter codes for the United States and its possessions.

   AUXILIARY CODE:
	   lynx -dump http://www.usps.gov/ncsc/lookups/usps_abbreviations.htm > kruft.txt
	   kruft2codes.pl

COPYRIGHT INFO
       Copyright (c) 2002 - $present Terrence Brannon.

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

       License: GPL, Artistic, available in the Debian Linux Distribution at /usr/share/common-licenses/{GPL,Artistic}

AUTHOR
       T. M. Brannon, <tbone@cpan.org>

   PATCHES
       Thanks to stevet AT ibrinc for a patch about second call to new failing.

perl v5.12.4							    2011-08-03							   Locale::US(3pm)