Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Array::Iterator::BiDirUseroContributed Perl DArray::Iterator::BiDirectional(3)

NAME
       Array::Iterator::BiDirectional -	A subclass of Array::Iterator to allow
       forwards	and backwards iteration

VERSION
       This document describes version 0.12 of Array::Iterator::BiDirectional
       (from Perl distribution Array-Iterator),	released on 2017-07-04.

SYNOPSIS
	 use Array::Iterator::BiDirectional;

	 # create an instance of the iterator
	 my $i = Array::Iterator::BiDirectional->new(1 .. 100);

	 while ($some_condition_exists)	{
	     # get the latest item from
	     # the iterator
	     my	$current = $i->get_next();
	     # ...
	     if	($something_happens) {
		 # back	up the iterator
		 $current = $i->get_previous();
	     }
	 }

DESCRIPTION
       Occasionally it is useful for an	iterator to go in both directions,
       forward and backward. One example would be token	processing. When
       looping though tokens it	is sometimes necessary to advance forward
       looking for a match to a	rule. If the match fails, a bi-directional
       iterator	can be moved back so that the next rule	can be tried.

ORIGINAL AUTHOR
       stevan little, <stevan@iinteractive.com>

ORIGINAL COPYRIGHT AND LICENSE
       Copyright 2004 by Infinity Interactive, Inc.

       <http://www.iinteractive.com>

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

METHODS
       This is a subclass of Array::Iterator, only those methods that have
       been added are documented here, refer to	the Array::Iterator
       documentation for more information.

       has_previous([$n])
	   This	method works much like "hasNext" does, it will return true (1)
	   unless the beginning	of the array has been reached, and false (0)
	   otherwise.

	   Optional argument has the same meaning except that it specifies
	   $nth	previous element.

       previous
	   This	method is much like "next". It will return the previous	item
	   in the iterator, and	throw an exception if it attempts to reach
	   past	the beginning of the array.

       get_previous
	   This	method is much like "get_next".	It will	return the previous
	   item	in the iterator, and return undef if it	attempts to reach past
	   the beginning of the	array.

       look_back([$n])
	   This	is the counterpart to "peek", it will return the previous
	   items in the	iterator, but will not affect the internal counter.

	   Optional argument has the same meaning except that it specifies
	   $nth	previous element.

HOMEPAGE
       Please visit the	project's homepage at
       <https://metacpan.org/release/Array-Iterator>.

SOURCE
       Source repository is at
       <https://github.com/sharyanto/perl-Array-Iterator>.

BUGS
       Please report any bugs or feature requests on the bugtracker website
       <https://rt.cpan.org/Public/Dist/Display.html?Name=Array-Iterator>

       When submitting a bug or	request, please	include	a test-file or a patch
       to an existing test-file	that illustrates the bug or desired feature.

SEE ALSO
       This is a subclass of Array::Iterator, please refer to it for more
       documenation.

AUTHOR
       perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE
       This software is	copyright (c) 2017, 2013, 2012,	2011 by
       perlancar@cpan.org.

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

perl v5.32.0			  2017-07-04 Array::Iterator::BiDirectional(3)

NAME | VERSION | SYNOPSIS | DESCRIPTION | ORIGINAL AUTHOR | ORIGINAL COPYRIGHT AND LICENSE | METHODS | HOMEPAGE | SOURCE | BUGS | SEE ALSO | AUTHOR | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Array::Iterator::BiDirectional&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help