CGI::Listman::dictionary - list of and informations about CGI form parameters
use CGI::Listman::dictionary;
A dictionary mainly serves two purposes: first, it gives the list manager a reference for what database rows are in use; second, it makes the connection between your web representation of those rows (definition) and checks whether some fields are mandatory or not.
This helps you build web pages where each mentionned field can have a readable name. For example, let's say you have a form with a field internally identified with "user_name". If the user forgets or refuses to fill in this field, CGI::Listman will return you a list containing it among other similar fields (see the check_params method of the CGI::Listman class). Furthermore, your error page could contain a more explicit field name such as "User Identification" instead of the silly "user_name" identifier.
This functionality is somewhat limited at this stage since CGI::Listman only checks the presence of mandatory fields, yet it considers strings of whitespaces as empty strings. Otherwise, it does not enforce semantics over those field. Until this is implemented, I recommend you have a look at Mark Stosberg's Data::FormValidator or Francis J. Lacoste's HTML::FormValidator modules which seem to do a pretty job.
Constructor with a an argument specifying the filename where to store the dictionary informations.
The parameter "filename" is optional with this method.
A string representing the path to your dictionary's storage file.
A reference to a blessed instance of CGI::Listman::dictionary.
Append an instance of CGI::Listman::dictionary::term to your dictionary's list of terms.
A reference to the instance of CGI::Listman::dictionary::term you want to add to your dictionary.
This method returns nothing.
This method returns the CGI::Listman::dictionary::term corresponding to the key given as parameter.
The key of the term you wish to be returned.
A reference to an instance of CGI::Listman::dictionary::term or undef if the key was not found.
Returns the list of terms.
This method takes no parameter.
A reference to the ARRAY containing the list of terms.
An instance of CGI::Listman::dictionary::term you wish to know the position of in the list.
This method returns an integer corresponding to that term in the list's order or -1 if the term was not found.
This functions serves the purpose of reposition a term relatively to its siblings. Giving a value that is to high or low will silently cancel the operation. This function is generally called by the increase_... and decrease_... functions.
An instance of CGI::Listman::dictionary::term you wish to move in the dictionary's internal list.
An positive or negative integer giving the number of steps the term has to be moved from.
This method is similar to reposition_term above except that its increment is optional. If not present, the increment is assumed to be 1.
An optional positive or negative integer giving the number of steps the term has to be moved from.
This method is similar to reposition_term above except that its decrement is optional and considered negative. If not present, the decrement is assumed to be 1.
The key corresponding to the CGI::Listman::dictionary::term you would like to increase in the list.
An integer representing the amount of slots to increment the term by. If not specified, this amount will be 1.
The key corresponding to the CGI::Listman::dictionary::term you would like to move in the list.
An integer representing the amount of slots to decrement the term by. If not specified, this amount will be 1.
Wolfgang Sourdeau, <Wolfgang@Contre.COM>
Copyright (C) 2002 iScream multimédia <info@iScream.ca>
This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
CGI::Listman::dictionary::term(3)
1 POD Error
The following errors were encountered while parsing the POD:
Non-ASCII character seen before =encoding in 'multimédia'. Assuming CP1252
To install CGI::Listman, copy and paste the appropriate command in to your terminal.
cpanm
cpanm CGI::Listman
CPAN shell
perl -MCPAN -e shell install CGI::Listman
For more information on module installation, please visit the detailed CPAN module installation guide.