diff options
| author | andreas_kupries <akupries@shaw.ca> | 2004-07-16 22:22:35 (GMT) |
|---|---|---|
| committer | andreas_kupries <akupries@shaw.ca> | 2004-07-16 22:22:35 (GMT) |
| commit | 410ec19ed82d84923284f0ffcd8b01e3467c34e2 (patch) | |
| tree | 374a5fdb4c5c587e736ef19da8e7b86f3d15458d /doc/OpenFileChnl.3 | |
| parent | 1ccba0c56984c2bdc4eeb4775e19dcefdd20cc46 (diff) | |
| download | tcl-410ec19ed82d84923284f0ffcd8b01e3467c34e2.zip tcl-410ec19ed82d84923284f0ffcd8b01e3467c34e2.tar.gz tcl-410ec19ed82d84923284f0ffcd8b01e3467c34e2.tar.bz2 | |
* doc/OpenFileChnl.3: Added description of the behaviour of
Tcl_ReadChars when its 'charsToRead' argument is set to
-1. Fixes [Tcl SF Bug 934511].
Diffstat (limited to 'doc/OpenFileChnl.3')
| -rw-r--r-- | doc/OpenFileChnl.3 | 6 |
1 files changed, 5 insertions, 1 deletions
diff --git a/doc/OpenFileChnl.3 b/doc/OpenFileChnl.3 index cf99bab..295f055 100644 --- a/doc/OpenFileChnl.3 +++ b/doc/OpenFileChnl.3 @@ -4,7 +4,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: OpenFileChnl.3,v 1.24 2004/05/17 09:19:59 dkf Exp $ +'\" RCS: @(#) $Id: OpenFileChnl.3,v 1.25 2004/07/16 22:22:35 andreas_kupries Exp $ .so man.macros .TH Tcl_OpenFileChannel 3 8.3 Tcl "Tcl Library Procedures" .BS @@ -433,6 +433,10 @@ that were stored in \fIreadObjPtr\fR. If an error occurs while reading, the return value is \-1 and \fBTcl_ReadChars\fR records a POSIX error code that can be retrieved with \fBTcl_GetErrno\fR. .PP +Setting \fIcharsToRead\fR to \fB-1\fR will cause the command to read +all characters currently available (non-blocking) or everything until +eof (blocking mode). +.PP The return value may be smaller than the value to read, indicating that less data than requested was available. This is called a \fIshort read\fR. In blocking mode, this can only happen on an end-of-file. In nonblocking mode, |