Nigel Horne > CGI-Untaint-CountyStateProvince-US > CGI::Untaint::CountyStateProvince::US

Download:
CGI-Untaint-CountyStateProvince-US-0.02.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.02   Source  

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

syntax highlighting: