List::Cycle

Cycle(3)	     User Contributed Perl Documentation	     Cycle(3)



NAME
       List::Cycle - Objects for cycling through a list of values

VERSION
       Version 0.04

SYNOPSIS
	   use List::Cycle;

	   my $color = List::Cycle->new( {values => [’#000000’, ’#FAFAFA’, ’#BADDAD’]} );
	   print $color->next; # #000000
	   print $color->next; # #FAFAFA
	   print $color->next; # #BADDAD
	   print $color->next; # #000000

FUNCTIONS
       new( {values => \@values} )

       Creates a new cycle object, using @values.

       The "values" keyword can be "vals", if you like.

       "$cycle->set_values(\@values)"

       Sets the cycle values and resets the internal pointer.

       $cycle->reset

       Sets the internal pointer back to the beginning of the cycle.

	   my $color = List::Cycle->new( {values => [qw(red white blue)]} );
	   print $color->next; # red
	   print $color->next; # white
	   $color->reset;
	   print $color->next; # red

       $cycle->dump

       Returns a handy string representation of internals.

       $cycle->next

       Gives the next value in the sequence.

AUTHOR
       Andy Lester, "<andy at petdance.com>"

SUPPORT
       You can find documentation for this module with the perldoc command.

	   perldoc List::Cycle

       You can also look for information at:

       * AnnoCPAN: Annotated CPAN documentation
	   <http://annocpan.org/dist/List-Cycle>

       * CPAN Ratings
	   <http://cpanratings.perl.org/d/List-Cycle>

       * RT: CPAN’s request tracker
	   <http://rt.cpan.org/NoAuth/Bugs.html?Dist=List-Cycle>

       * Search CPAN
	   <http://search.cpan.org/dist/List-Cycle>

BUGS
       Please report any bugs or feature requests to "bug-list-cycle @
       rt.cpan.org", or through the web interface at
       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=List-Cycle>.  I will
       be notified, and then you’ll automatically be notified of progress on
       your bug as I make changes.

ACKNOWLEDGEMENTS
       List::Cycle is a playground that uses some of the ideas in Damian Con-
       way’s marvelous Perl Best Practices.  <http://www.oreilly.com/cata-
       log/perlbp/> One of the chapters mentions a mythical List::Cycle mod-
       ule, so I made it real.

       Thanks also to Ricardo SIGNES for patches.

COPYRIGHT & LICENSE
       Copyright 2005 Andy Lester, All Rights Reserved.

       This program is free software; you can redistribute it and/or modify
       it under the same terms as Perl itself.



perl v5.8.8			  2005-11-10			     Cycle(3)