藤 吾郎 > IO-Handle-unread > IO::Handle::unread

Download:
IO-Handle-unread-0.02.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.02   Source  

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 ^

IO::Handle.

perliol.

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.

syntax highlighting: