NAME
CGI::Listman::selection - managing CGI::Listman::line's in batch
SYNOPSIS
use CGI;
use CGI::Listman;
use CGI::Listman::selection;
my $cgi = CGI->new ();
my $list_manager = CGI::Listman->new ();
[...]
my $selection = CGI::Listman::selection->new ();
foreach my $param ($cgi->param ()) {
if ($param =~ m/^select_([0-9].*$)/) {
$selection->add_line_by_number ($listman, $1);
}
}
DESCRIPTION
A CGI::Listman::selection encapsulates an array of selected lines for further batch processing. This is handy for example in an administration interface when the developer wants to export or erase several lines at a time from the database.
API
new
Creates, initializes and returns a new instance of CGI::Listman::selection for you to enjoy and work with.
- Parameters
-
This method takes no parameter.
- Return values
-
A blessed instance of CGI::Listman::selection.
add_line
Use this method to add a CGI::Listman::line to your selection.
- Parameters
-
- line
-
A single instance of CGI::Listman::line to be exported.
- Return values
-
This method returns nothing.
add_line_by_number
This method helps you adding a line by number. The first parameter has to be its contextual instance of CGI::Listman. Without it, a line cannot be guaranteed to be numbered since line numbers make no sense when they are not part of a CGI::Listman.
- Parameters
-
- list_manager
-
An instance of CGI::Listman.
- number
-
An integer representing the CGI::Listman::line you want to add to your selection.
- Return values
-
This method returns nothing.
add_lines_by_number
Same as above, except that it takes a reference to an ARRAY of numbers.
- Parameters
-
- list_manager
-
An instance of CGI::Listman.
- numbers
-
A reference to an ARRAY of integers representing the CGI::Listman::line's you want to add to your selection.
- Return values
-
This method returns nothing.
AUTHOR
Wolfgang Sourdeau, <Wolfgang@Contre.COM>
COPYRIGHT
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.
SEE ALSO
CGI::Listman::line(3) CGI::Listman::exporter(3)
1 POD Error
The following errors were encountered while parsing the POD:
- Around line 205:
Non-ASCII character seen before =encoding in 'multimédia'. Assuming CP1252