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

The state name is returned in uc() format.
neither hash is strict, though they should be.

AUTHOR

Currently maintained by Mike Accardo, <accardo@cpan.org>

Original author T. M. Brannon

PATCHES

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

COPYRIGHT

    Copyright (c) 2015 Mike Accardo
    Copyright (c) 2002-2014 Terrence Brannon