table of contents
gets(3tcl) | Tcl Built-In Commands | gets(3tcl) |
NAME¶
gets - 从一个通道读一行
总览 SYNOPSIS¶
gets channelId ?varName?
描述 DESCRIPTION¶
这个命令从 channelId 读下一行,返回直到(但不包括)行结束字符的行中所有字符,并抛弃行结束字符。如果省略了 varName,把这一行作为命令的结果返回。如果指定了 varName ,则把这一行放置到叫这个名字的变量中而返回值是返回的字符总数。
如果在检索行结束的时候遇到了文件结束,命令返回直到文件结束可获得的所有输入。如果 channelId在非阻塞模式下并且不能获得完整的一行的输入,命令返回一个空串并不消耗任何输入。因为文件结束或因为在非阻塞模式下数据不充足,如果指定了 varName 并切返回了一个空串,则返回的总数是 -1。注意如果未指定 varName 则在文件结束和没有可获得的完整的一行的情况下产生的结果与输入行只由一个行结束字符组成同样。使用eof 和 fblocked命令来区别这三种情况。
参见 SEE ALSO¶
file(n), eof(n), fblocked(n)
关键字 KEYWORDS¶
blocking, channel, end of file, end of line, line, nonblocking, read
[中文版维护人]¶
寒蝉退士
[中文版最新更新]¶
2001/09/02
《中国 Linux 论坛 man 手册页翻译计划》:¶
跋¶
本页面中文版由中文
man 手册页计划提供。
中文 man
手册页计划:https://github.com/man-pages-zh/manpages-zh
7.5 | Tcl |