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