NAME

Filesys::POSIX::IO::Handle - Basic wrapper for Perl file handles

DESCRIPTION

This package provides a wrapper for standard Perl file handles. It is not meant to supplant the behavior or necessity of IO::Handle; rather, it is meant to provide a base reference for all of the I/O operations supported by Filesys::POSIX, which ignores concerns such as buffering and the like.

METHODS

Filesys::POSIX::IO::Handle->new($fh)

Returns a blessed reference to the file handle passed.

$handle->write($buf, $len)

Calls "syswrite" in perlfunc on the current file handle, passing the $buf and $len arguments literally. Returns the result of "syswrite" in perlfunc.

$handle->print(@args)

Prints a concatenation of each item passed, joined by $/, to the current file handle.

$handle->sprintf($format, @args)

Prints a formatted string to the current file handle. Uses "sprintf" in perlfunc.

$handle->read($buf, $len)

Reads $len bytes from $handle into $buf.

$handle->seek($pos, $whence)

Seek $handle to $pos bytes, relative to the current byte position, according to the seek mode listed in $whence. $whence is a position modifier as specified in Filesys::POSIX::Bits.

$handle->tell

Returns the current absolute byte position of the current file $handle.

$handle->close

Close the current file handle.

SEE ALSO

Filesys::POSIX::Mem::Bucket

Provides an implementation of the interface described herein, but for access to regular file data for Filesys::POSIX::Mem filesystem hierarchies.

AUTHOR

Written by Xan Tronix <xan@cpan.org>

CONTRIBUTORS

Rikus Goodell <rikus.goodell@cpanel.net>

Brian Carlson <brian.carlson@cpanel.net>

COPYRIGHT

Copyright (c) 2014, cPanel, Inc. Distributed under the terms of the Perl Artistic license.