NAME
IO::Handle::unread - Pushes string back into input filehandle
VERSION
This document describes IO::Handle::unread version 0.02
SYNOPSIS
use IO::Handle::unread;
*STDIN->unread("foo\n");
print scalar <STDIN>; # => "foo\n"DESCRIPTION
This module provides IO::Handle class with unread(), a superset of stdio's ungetc().
Since the unread() routines of some layers are unstable, do not use this module for anything serious. There is NO WARRANTY.
INTERFACE
FILEHANDLE->unread(string [, length])
Pushes string back into FILEHANDLE, which is available for subsequent read operations.
This method returns the unreaded byte length.
EXAMPLE
Here is an implementation of ungetc(), which deals with one-byte string.
sub ungetc{
my($in, $char) = @_;
$in->unread($char, 1) == 1 ? $char : undef;
}CONFIGURATION AND ENVIRONMENT
IO::Handle::unread requires no configuration files or environment variables.
DEPENDENCIES
Perl 5.8.1 or later.
BUGS AND LIMITATIONS
No bugs have been reported.
Please report any bugs or feature requests to bug-io-handle-unread@rt.cpan.org/, or through the web interface at http://rt.cpan.org/.
SEE ALSO
AUTHOR
Goro Fuji <gfuji(at)cpan.org>.
LICENSE AND COPYRIGHT
Copyright (c) 2008, Goro Fuji <gfuji(at)cpan.org>. Some rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.