NAME PerlIO::fgets - Provides a "fgets()" like function for PerlIO file handles SYNOPSIS $octets = fgets(STDIN, 1024); $octets = fgets(*STDIN, 1024); $octets = fgets(\*STDIN, 1024); while ( ! eof($fh) ) { defined( $_ = fgets($fh, 1024) ) or die "fgets failed: $!"; ... } DESCRIPTION Provides a "fgets()" like function for PerlIO file handles FUNCTIONS fgets Attempts to read a line from the given file handle $fh. *Usage* $octets = fgets($fh, $maximum); *Arguments* $fh The file handle to read from. Must be a PerlIO file handle. $maximum A positive integer containing the maximum number of octets to be read from the file handle (including the trailing newline character). *Returns* If "fgets" encounters end-of-file before a newline or $maximum octets read before a newline, it returns the octets. If "fgets" reaches end-of-file before reading any octets, it returns an empty string. If unsuccessful, "fgets" returns "undef" and $! contains the I/O error. *Note* Unlike stdio's "fgets()", this implementation is not sensitive to input containing null characters. EXPORTS "fgets" LIMITATIONS Current implementation has no understanding of Unicode (UTF-X), only octets. PREREQUISITES Run-Time perl 5.6 or greater. Exporter, core module. Build-Time In addition to Run-Time: C compiler. Test::More 0.47 or greater, core module since 5.6.2. Test::HexString. IO::File. SEE ALSO File::GetLineMaxLength. File::fgets. SUPPORT Please report any bugs or feature requests to "bug-perlio-fgets@rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=PerlIO-fgets> AUTHOR Christian Hansen "chansen@cpan.org" COPYRIGHT Copyright 2010 by Christian Hansen. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.