NAME
CGI::Thin - A very lightweight Parser for CGI Forms
SYNOPSIS
use CGI::Thin;
use strict;
my %cgi_data = &Parse_CGI ();
DESCRIPTION
This module is a very lightweight parser of CGI forms. And it has a
special feature that it will return an array if the same key is used
twice in the form. And you can force an array to avoid complications.
The hash %cgi_data will have all the form data from either a POST or GET form
and will also work for "multipart/form-data" forms necessary for uploading files.
USAGE
Functions
* `CGI::Thin::Parse_CGI(@keys)'
The optional @keys will be used to force arrays to be returned.
The function also has special features for getting multiple values for a
single form key. For example if we have this form...
red
green
blue
One of three things can happen.
1) The user does not select any color.
So $cgi_data{'color'} will not exist.
2) The user selects exactly one color.
So $cgi_data{'color'} will be the scalar value selected.
3) The user selects exactly more than one color.
So $cgi_data{'color'} will be a reference to an array of the values selected.
To fix this you could call the parser by giving it a list of keys that you want
to force to be arrays. In this case like...
use CGI::Thin;
my %cgi_data = &Parse_CGI ('color');
Now it they pick exactly one color, $cgi_data{'color'} will be a reference to
an array of the one value selected. And thus there will be no need for
special cases later in the code.
BUGS
Following is a list of known or reported bugs.
Fixed
Pending
SUPPORT
Visit CGI::Thin's web site at
http://www.platypiventures.com/perl/modules/cgi_thin.shtml
AUTHOR
R. Geoffrey Avery
CPAN ID: RGEOFFREY
rGeoffrey@PlatypiVentures.com
http://www.PlatypiVentures.com/perl