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

FreeBSD Manual Pages

  
 
  

home | help
IO::Handle::Iterator(3User Contributed Perl DocumentatiIO::Handle::Iterator(3)

NAME
       IO::Handle::Iterator - Iterator based read handle

SYNOPSIS
	   IO::Handle::Iterator->new(sub {
	       return $next_line; # or undef on	eof
	   });

DESCRIPTION
       This class lets you define a read handle	with a few fallback methods
       (like "read") using a single callback that behaves like "getline".

       This is similar but much	simpler	than:

	   IO::Handle::Prototype::Fallback->new(
	       __read => sub { ... },
	   );

       The reason being	that the IO::Handle::Prototype::Fallback
       implementation will try its very	best to	behave correctly (i.e. respect
       the value of $/), whereas this implementation assumes it's fine to
       return things that aren't exactly lines from "getline", so the values
       are just	passed through.

READ BUFFERING
       When a method that requires buffering is	invoked	the handle is
       reblessed to a subclass which handles buffering.

       Calling "getline" again on this object will return the value of the
       buffer and return to the	normal iterator	class.

perl v5.24.1			  2009-09-29	       IO::Handle::Iterator(3)

NAME | SYNOPSIS | DESCRIPTION | READ BUFFERING

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

home | help