/ 
CGI-Untaint-CountyStateProvince-US-0.02
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.02

SYNOPSIS

Adds a list of U.S. states to the list of counties/state/provinces which are known by the CGI::Untaint::CountyStateProvince validator so that an HTML form sent by CGI 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');
# ...

SUBSOUTINES/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 which is 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-gb 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 progress on your bug as I make changes.

SEE ALSO

CGI::Untaint::CountyStateProvince, CGI::Untaint

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 Nigel Horne.

This program is released under the following licence: GPL