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 手冊頁翻譯計劃》:
http://cmpp.linuxforum.net

跋
本頁面中文版由中文 man 手冊頁計劃提供。
中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh