new

Constructor. Creates a new IO::Handle object.

new_from_fd (fd, mode)

Constructor. Like new, creates an IO::Handle object. It requires two parameters, which are passed to the method fdopen; if fdopen fails, the object is destroyed. Otherwise, it is returned to the caller.

$fh->clearerr

Clears the given handle's error indicator.

$fh->error

Returns true if the given handle has experienced any errors since it was opened or since the last call to clearerr.

$fh->fdopen (fd, mode)

Like an ordinary open except that the first parameter is a filehandle name, an IO::Handle object, or a file descriptor number.

$fh->flush

Flushes the given handle's buffer.

$fh->getline

Works like <$fh>, described in the section on "I/O Operators" in the perlop manpage, but is more readable and can be safely called in an array context, while still returning one line.

$fh->getlines

Works like <$fh> when called in an array context to read all the remaining lines in a file, but is more readable. croak s if called in scalar context.

$fh->opened

Returns true if the object is currently a valid file descriptor.

$fh->ungetc (ord)

Pushes a character with the ordinal value ord back onto the given handle's input stream.

$fh->untaint

Special method for working under -T and setuid/gid scripts. Marks the object as taint-clean, and as such, data read from it is also considered taint-clean.