io::handle::prototype::fallback(3pm) [debian man page]

IO::Handle::Prototype::Fallback(3pm)			User Contributed Perl Documentation		      IO::Handle::Prototype::Fallback(3pm)

NAME

       IO::Handle::Prototype::Fallback - Create IO::Handle like objects using a set of callbacks.

SYNOPSIS

	   my $fh = IO::Handle::Prototype::Fallback->new(
	       getline => sub {
		   my $fh = shift;

		   ...
	       },
	   );

DESCRIPTION

       This class provides a way to define a filehandle based on callbacks.

       Fallback implementations are provided to the extent possible based on the provided callbacks, for both writing and reading.

SPECIAL CALLBACKS

       This class provides two additional methods on top of IO::Handle, designed to let you implement things with a minimal amount of baggage.

       The fallback methods are all best implemented using these, though these can be implemented in terms of Perl's standard methods too.

       However, to provide the most consistent semantics, it's better to do this:

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

       Than this:

	   IO::Handle::Prototype::Fallback->new(
	       getline => sub {
		   shift @array;
	       },
	   );

       Because the fallback implementation of "getline" implements all of the extra crap you'd need to handle to have a fully featured
       implementation.

       __read
	   Return a chunk of data of any size (could use $/ or not, it depends on you, unlike "getline" which probably should respect the value of
	   $/).

	   This avoids the annoying "substr" stuff you need to do with "read".

       __write $string
	   Write out a string.

	   This is like a simplified "print", which can disregard $, and "$" as well as multiple argument forms, and does not have the extra
	   "substr" annoyance of "write" or "syswrite".

WRAPPING

       If you provide a single reading related callback ("__read", "getline" or "read") then your callback will be used to implement all of the
       other reading primitives using a string buffer.

       These implementations handle $/ in all forms ("undef", ref to number and string), all the funny calling conventions for "read", etc.

FALLBACKS

       Any callback that can be defined purely in terms of other callbacks in a way will be added. For instance "getc" can be implemented in terms
       of "read", "say" can be implemented in terms of "print", "print" can be implemented in terms of "write", "write" can be implemented in
       terms of "print", etc.

       None of these require special wrapping and will always be added if their dependencies are present.

GLOB OVERLOADING

       When overloaded as a glob a tied handle will be returned. This allows you to use the handle in Perl's IO builtins. For instance:

	   my $line = <$fh>

       will not call the "getline" method natively, but the tied interface arranges for that to happen.

perl v5.10.1							    2009-09-29				      IO::Handle::Prototype::Fallback(3pm)

Check Out this Related Man Page

IO::Pipe(3pm)						 Perl Programmers Reference Guide					     IO::Pipe(3pm)

NAME

       IO::Pipe - supply object methods for pipes

SYNOPSIS

	       use IO::Pipe;

	       $pipe = IO::Pipe->new();

	       if($pid = fork()) { # Parent
		   $pipe->reader();

		   while(<$pipe>) {
		       ...
		   }

	       }
	       elsif(defined $pid) { # Child
		   $pipe->writer();

		   print $pipe ...
	       }

	       or

	       $pipe = IO::Pipe->new();

	       $pipe->reader(qw(ls -l));

	       while(<$pipe>) {
		   ...
	       }

DESCRIPTION

       "IO::Pipe" provides an interface to creating pipes between processes.

CONSTRUCTOR

       new ( [READER, WRITER] )
	   Creates an "IO::Pipe", which is a reference to a newly created symbol (see the "Symbol" package). "IO::Pipe::new" optionally takes two
	   arguments, which should be objects blessed into "IO::Handle", or a subclass thereof. These two objects will be used for the system call
	   to "pipe". If no arguments are given then method "handles" is called on the new "IO::Pipe" object.

	   These two handles are held in the array part of the GLOB until either "reader" or "writer" is called.

METHODS

       reader ([ARGS])
	   The object is re-blessed into a sub-class of "IO::Handle", and becomes a handle at the reading end of the pipe. If "ARGS" are given
	   then "fork" is called and "ARGS" are passed to exec.

       writer ([ARGS])
	   The object is re-blessed into a sub-class of "IO::Handle", and becomes a handle at the writing end of the pipe. If "ARGS" are given
	   then "fork" is called and "ARGS" are passed to exec.

       handles ()
	   This method is called during construction by "IO::Pipe::new" on the newly created "IO::Pipe" object. It returns an array of two objects
	   blessed into "IO::Pipe::End", or a subclass thereof.

SEE ALSO

       IO::Handle

AUTHOR

       Graham Barr. Currently maintained by the Perl Porters.  Please report all bugs to <perlbug@perl.org>.

COPYRIGHT

       Copyright (c) 1996-8 Graham Barr <gbarr@pobox.com>. 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.16.2							    2012-10-11							     IO::Pipe(3pm)

Linux and UNIX Man Pages

io::handle::prototype::fallback(3pm) [debian man page]

Check Out this Related Man Page