diff options
Diffstat (limited to 'tcl/doc/read.n')
| -rw-r--r-- | tcl/doc/read.n | 34 |
1 files changed, 21 insertions, 13 deletions
diff --git a/tcl/doc/read.n b/tcl/doc/read.n index f294a8bff04..113c9c61626 100644 --- a/tcl/doc/read.n +++ b/tcl/doc/read.n @@ -8,7 +8,7 @@ '\" RCS: @(#) $Id$ '\" .so man.macros -.TH read n 7.5 Tcl "Tcl Built-In Commands" +.TH read n 8.1 Tcl "Tcl Built-In Commands" .BS '\" Note: do not modify the .SH NAME line immediately below! .SH NAME @@ -16,7 +16,7 @@ read \- Read from a channel .SH SYNOPSIS \fBread \fR?\fB\-nonewline\fR? \fIchannelId\fR .sp -\fBread \fIchannelId numBytes\fR +\fBread \fIchannelId numChars\fR .BE .SH DESCRIPTION @@ -25,26 +25,34 @@ In the first form, the \fBread\fR command reads all of the data from \fIchannelId\fR up to the end of the file. If the \fB\-nonewline\fR switch is specified then the last character of the file is discarded if it is a newline. -In the second form, the extra argument specifies how many bytes to -read. Exactly that many bytes will be read and returned, unless -there are fewer than \fInumBytes\fR left in the file; in this case -all the remaining bytes are returned. +.VS 8.1 +In the second form, the extra argument specifies how many characters to +read. Exactly that many characters will be read and returned, unless +there are fewer than \fInumChars\fR left in the file; in this case +all the remaining characters are returned. If the channel is +configured to use a multi-byte encoding, then the number of characters +read may not be the same as the number of bytes read. .PP -If \fIchannelId\fR is in nonblocking mode, the command may not read -as many bytes as requested: once all available input has been read, -the command will return the data that is available rather than blocking -for more input. +If \fIchannelId\fR is in nonblocking mode, the command may not read as +many characters as requested: once all available input has been read, +the command will return the data that is available rather than +blocking for more input. If the channel is configured to use a +multi-byte encoding, then there may actually be some bytes remaining +in the internal buffers that do not form a complete character. These +bytes will not be returned until a complete character is available or +end-of-file is reached. +.VE 8.1 The \fB\-nonewline\fR switch is ignored if the command returns before reaching the end of the file. .PP \fBRead\fR translates end-of-line sequences in the input into newline characters according to the \fB\-translation\fR option for the channel. -See the manual entry for \fBfconfigure\fR for details on the -\fB\-translation\fR option. +See the \fBfconfigure\fR manual entry for a discussion on ways in +which \fBfconfigure\fR will alter input. .SH "SEE ALSO" eof(n), fblocked(n), fconfigure(n) .SH KEYWORDS -blocking, channel, end of line, end of file, nonblocking, read, translation +blocking, channel, end of line, end of file, nonblocking, read, translation, encoding |