NAME

CIAO::Lib::Param::Match - handle a list of matched parameters

SYNOPSIS

use CIAO::Lib::Param;

$pf = CIAO::Lib::Param->new( $filename );
$pmatch = $pf->match( $template );

printf "number of matched parameters: %d\n", $pmatch->length;
while( my $pname = $pmatch->next ) { print "$pname\n" };

# do it all over again
$pmatch->rewind;

DESCRIPTION

These routines manipulate the CIAO::Lib::Param::Match object returned by the CIAO::Lib::Param match() method.

Methods

length

$len = $pmatch->length;

returns the number of matched parameters.

next

$pname = $pmatch->next;

returns the name of the next parameter in the list. It returns undef if at the end of the list.

rewind

$pmatch->rewind;

Reset the list so that the next call to next() will return the first element of the list.

SEE ALSO

CIAO::Lib::Param.

AUTHOR

Diab Jerius, <djerius@cpan>

COPYRIGHT AND LICENSE

Copyright (C) 2005 by the Smithsonian Astrophysical Observatory

This code is released under the GNU General Public License. You may find a copy at <http://www.fsf.org/copyleft/gpl.html>.