read FILEHANDLE,SCALAR,LENGTH,OFFSET
read FILEHANDLE,SCALAR,LENGTH
Attempts to read LENGTH *characters* of data into variable
SCALAR from the specified FILEHANDLE. Returns the number of
characters actually read, 0 at end of file, or undef if there
was an error (in the latter case $! is also set). SCALAR will be
grown or shrunk so that the last character actually read is the
last character of the scalar after the read.
An OFFSET may be specified to place the read data at some place
in the string other than the beginning. A negative OFFSET
specifies placement at that many characters counting backwards
from the end of the string. A positive OFFSET greater than the
length of SCALAR results in the string being padded to the
required size with "\0" bytes before the result of the read is
appended.
The call is implemented in terms of either Perl's or your
system's native fread(3) library function, via the PerlIO layers
applied to the handle. To get a true read(2) system call, see
sysread.
Note the *characters*: depending on the status of the
filehandle, either (8-bit) bytes or characters are read. By
default, all filehandles operate on bytes, but for example if
the filehandle has been opened with the ":utf8" I/O layer (see
"open", and the open pragma), the I/O will operate on
UTF8-encoded Unicode characters, not bytes. Similarly for the
":encoding" layer: in that case pretty much any characters can
be read.
Generated by phpman local Author: Che Dong Under GNU General Public License
2026-06-15 06:59 @216.73.216.200
CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)