CGI::Untaint::boolean - untaint boolean values from CGI programs
use CGI::Untaint; my $handler = CGI::Untaint->new( $q->Vars() ); my $boolean = $handler->extract( -as_boolean => 'some_feature' );
This input handler verifies that it is dealing with a reasonable boolean value, probably from a checkbox with no value specified. In this case, "reasonable" means that the value is on, if the checkbox is checked, or empty, if the client did not send a value.
on
Note: the value() method will return either true or false. It will not return the string "on" or the empty string. It's boolean for a reason! (Don't count on it returning 0 for false either; false is just false.)
value()
0
is_valid()
Returns true if the value for this checkbox is valid, setting the value to true if the value is on, false otherwise.
CGI::Untaint, CGI::Untaint::object
chromatic, chromatic at wgz dot org
chromatic at wgz dot org
Thanks to Tony Bowden for helpful suggestions, Simon Wilcox for reporting a false value bug, with a test patch, and Dave Wilcox for helping to disambiguate the documentation.
No known bugs. Please report any to http://rt.cpan.org/.
Copyright (c) 2004 - 2005, chromatic. All rights reserved. You may use, modify, and distribute this module under the same terms as Perl 5.8.x itself, in the hope that it is useful but certainly under no guarantee.
To install CGI::Untaint::boolean, copy and paste the appropriate command in to your terminal.
cpanm
cpanm CGI::Untaint::boolean
CPAN shell
perl -MCPAN -e shell install CGI::Untaint::boolean
For more information on module installation, please visit the detailed CPAN module installation guide.