summaryrefslogtreecommitdiff
path: root/pod/perlfunc.pod
diff options
context:
space:
mode:
authorJarkko Hietaniemi <jhi@iki.fi>2000-12-21 04:44:52 +0000
committerJarkko Hietaniemi <jhi@iki.fi>2000-12-21 04:44:52 +0000
commit081c6eb8b01d00321c67b69968c625375007f58b (patch)
treee08ba6409c744c49d430719461e7befa7b3b625c /pod/perlfunc.pod
parent7ef822cddfe985045cd287429915d6f6aecd27c9 (diff)
downloadperl-081c6eb8b01d00321c67b69968c625375007f58b.tar.gz
read() documentation tweak for 20001121.004.
p4raw-id: //depot/perl@8215
Diffstat (limited to 'pod/perlfunc.pod')
-rw-r--r--pod/perlfunc.pod13
1 files changed, 7 insertions, 6 deletions
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index ed3f2dc6a3..f058baff7c 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -3506,12 +3506,13 @@ with the wrong number of RANDBITS.)
=item read FILEHANDLE,SCALAR,LENGTH
Attempts to read LENGTH bytes of data into variable SCALAR from the
-specified FILEHANDLE. Returns the number of bytes actually read,
-C<0> at end of file, or undef if there was an error. SCALAR will be grown
-or shrunk to the length actually read. An OFFSET may be specified to
-place the read data at some other place than the beginning of the
-string. This call is actually implemented in terms of stdio's fread(3)
-call. To get a true read(2) system call, see C<sysread>.
+specified FILEHANDLE. Returns the number of bytes actually read, C<0>
+at end of file, or undef if there was an error. SCALAR will be grown
+or shrunk to the length actually read. If SCALAR needs growing, the
+new bytes will be zero bytes. An OFFSET may be specified to place
+the read data into some other place in SCALAR than the beginning.
+The call is actually implemented in terms of stdio's fread(3) call.
+To get a true read(2) system call, see C<sysread>.
=item readdir DIRHANDLE