Version 0 of gets

Updated 2001-01-24 12:59:42

gets - Read a single line from a channel

  gets channelId
  gets channelId variable

Reads a single line from the specified channel. In the first form the characters of the line (with the exception of the end-of-line character) are returned as the result of the command. In the second form the characters of the line are written into the variable and the length of the line is returned instead.

When applied to a blocking channel the command will block until a line is complete or EOF was encountered. If the command is applied to a non-blocking channel and unable to read a complete line the first form of the command will return an empty string. The second form will return a -1 and refrain from setting the variable.

Do not use this command when Working with binary data. It will try to recognize end-of-line characters no matter what, even inside of packets.


Tcl syntax help