Iterator-Simple-Lookahead version 0.01 ====================================== Iterator::Simple::Lookahead - Simple iterator with lookahead and unget This module encapsulates an iterator function. An iterator function returns the next element in the stream on each call, and returns C on end of input. The iterator can return a code reference - this new iterator is inserted at the head of the queue. The object allows the user to C the Nth element of the stream without consuming it, or to get it and remove from the stream. A list of items can also be pushed back to the stream by C, to be retrieved in the subsequent C calls. The next item can also be retrieved by calling C<$iter-E()>. The input list to the constructor and to C contains items to be retrieved on each C call, or code references to be called to extract the next item from the stream. Other types of input can be converted to a code reference by C of L. This module is built on top of L and returns iterators that are compatible with the former, i.e. an object of type C can be used as an input to C. INSTALLATION To install this module type the following: perl Makefile.PL make make test make install DEPENDENCIES This module requires these other modules and libraries: Class::XSAccessor::Array, Iterator::Simple COPYRIGHT AND LICENCE Put the correct copyright and licence information here. Copyright (C) 2013 by Paulo Custodio This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.16.1 or, at your option, any later version of Perl 5 you may have available.