IO::Unread for Linux 1.03

IO::Unread is a Perl module that exports one function, unread, which will push data back onto a filehandle. Any amount of data can be pushed: if your perl is built with PerlIO layers, the data is stored in a special :pending layer; if not, the module ties the filehandle to a class which returns the unread data and unties itself.<br /><br />unread FILEHANDLE, LIST<br /><br />unread unreads LIST onto FILEHANDLE. If LIST is omitted, $_ is unread. Returns the number of characters unread on success, undef on failure. Warnings are produced under category io.<br /><br />Note that unread $FH, 'a', 'b' is equivalent to<br /><br /> unread $FH, 'a';<br /> unread $FH, 'b';<br /><br />, ie. to unread $FH, 'ba' rather than unread $FH, 'ab'.<br /><br />ungetc FILEHANDLE, STRING<br /><br />ungetc pushes the first character of STRING onto FILEHANDLE. Unlike unread, it does not use a tie implementation if your perl doesn't support PerlIO layers; rather it calls your ungetc(3). This is only guarenteed to support one character of pushback, and then only if it is the last character that was read from the handle.<br /><br />SYNOPSIS<br /><br /> use IO::Unread;<br /><br /> unread STDIN, "hello world<br />";<br /><br /> $_ = "goodbye";<br /> unread ARGV;

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Character,  Equivalent,  Failure,  Produced,  Pushes,  String,  Ungetc,  Warnings
Users rating:	0/10