NAME

CGI::Untaint::boolean - untaint boolean values from CGI programs

SYNOPSIS

use CGI::Untaint;

my $handler = CGI::Untaint->new( $q->Vars() );
my $boolean = $handler->extract( -as_boolean => 'some_feature' );

DESCRIPTION

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.

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.)

METHOD

is_valid()

Returns true if the value for this checkbox is valid, setting the value to true if the value is on, false otherwise.

SEE ALSO

CGI::Untaint, CGI::Untaint::object

AUTHOR

chromatic, 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.

BUGS

No known bugs. Please report any to http://rt.cpan.org/.

COPYRIGHT

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.