From: Jarkko Hietaniemi Date: Thu, 21 Dec 2000 04:44:52 +0000 (+0000) Subject: read() documentation tweak for 20001121.004. X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=081c6eb8b01d00321c67b69968c625375007f58b;p=p5sagit%2Fp5-mst-13.2.git read() documentation tweak for 20001121.004. p4raw-id: //depot/perl@8215 --- diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod index ed3f2dc..f058baf 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. +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. =item readdir DIRHANDLE