/ 
CGI-Untaint-CountyStateProvince-US-0.05
River stage zero No dependents
/ CGI::Untaint::CountyStateProvince::US

NAME

CGI::Untaint::CountyStateProvince::US - Add U.S. states to CGI::Untaint::CountyStateProvince tables

VERSION

Version 0.05

SYNOPSIS

The module validates that a given input, represents a valid U.S. state. It supports both full state names (e.g., "Maryland") and two-letter state abbreviations (e.g., "MD").

Adds a list of U.S. states to the list of counties/states/provinces which are known by the CGI::Untaint::CountyStateProvince validator allowing you to verify that a field in an HTML form contains a valid U.S. state.

You must include CGI::Untaint::CountyStateProvince::US after including CGI::Untaint, otherwise it won't work.

use CGI::Info;
use CGI::Untaint;
use CGI::Untaint::CountyStateProvince::US;
my $info = CGI::Info->new();
my $u = CGI::Untaint->new($info->params());
# Succeeds if state = 'MD' or 'Maryland', fails if state = 'Queensland';
$u->extract(-as_CountyStateProvince => 'state');
# ...

SUBROUTINES/METHODS

is_valid

Validates the data, setting the data to be the two-letter abbreviation for the given state. See CGI::Untaint::is_valid.

value

Sets the raw data to be validated. Called by the superclass, you are unlikely to want to call it.

AUTHOR

Nigel Horne, <njh at bandsman.co.uk>

BUGS

Only two-letter abbreviations are allowable, so 'Mass' won't work for Massachusetts.

Please report any bugs or feature requests to bug-cgi-untaint-csp-us at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CGI-Untaint-CountyStateProvince. I will be notified, and then you'll automatically be notified of the progress of your bug as I make changes.

SEE ALSO

CGI::Untaint::CountyStateProvince, CGI::Untaint, Locale::SubCountry

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc CGI::Untaint::CountyStateProvince::US

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2012-2025 Nigel Horne.

This program is released under the following licence: GPL2