Provided by: manpages-zh_1.5.1-1_all bug

NAME

       fileevent - 在一个通道变得可读或可写的时候执行一个脚本

 SYNOPSIS
       fileevent channelId readable ?script?

       fileevent channelId writable ?script?
_________________________________________________________________

 DESCRIPTION
       这个命令被用于建立鳌R桓鑫募事件处理器(handler)是在一个通道和一个脚本之间的一个绑定,这样在通道变得可读或可写的时候求这个脚本的值。通常使用文件事件处理器来允许在事件驱动的基础上从另一个进程接收数据,这样接受者可以在等待数据到来的时候继续与用户交互。如果一个应用在一个阻塞(模式下)的通道上调用
       getsread,而此时没有可获得的数据,在输入数据到来之前,进程将被阻塞,它将不能服务于其他事件,所以对于用户它象是被“冷冻”了。使用
       fileevent,进程可以在数据出现(present)的时候被告之,而只在不会导致阻塞的时候调用
       getsread  。

       给 fileeventchannelId   参数参照一个打开的通道,比如从以前的 opensocket   命令的得到的返回值。如果指定了  script    参数,则   fileevent
       建立一个新的事件处理器:     在通道变得可读或可写(依赖于给     fileevent
       的第二个参数)的时候求     script      的值。在这种情况下      fileevent
       返回一个空串。对于一个文件                  readablewritable事件处理器是独立的,可以单独的建立和删除。但是,在一个特定的解释器中在一个特定的时间上对于一个文件最多只能有一个readable和一个
       writable         处理器。如果调用       fileevent而此时指定的处理器已-
       在调用的解释器中存在,新的脚本替换旧的那个。

       如果没有指定           script             参数,fileeventchannelId返回当前的脚本,如果没有则返回一个空串。如果    指定    script
       参数为一个空串则删除这个事件处理器,如此将不会有脚本被调用。在一个通道被关闭或它的解释器被删除的时候文件的事件处理器也自动的被删除。

       如果在底层的设备上有可获得的未读的数据则把一个通道考虑为可读的。除了要从这个通道读的最近的尝试是不能在输入缓冲中找到一个完整的行的一个
       gets
       调用的特殊情况之外,如果在一个输入缓冲中有未读的数据也把一个通道考虑未可读的。这个特征允许使用事件从一个在非阻塞模式下的文件中一次读一行。如果在底层的文件或设备上有文件结束或出错的条件出现也把一个通道考虑为可读的。对于
       script
       检查这些条件和正确的处理它们是很重要的;例如,如果没有对文件结束的特定检查,可能发生一个无限的-
       环,这里script  读不到数据,返回,立即重新调用。

       如果至少数据中有一字节可以写到底层文件或设备中而不阻塞,或者在底层的文件或设备上有错误的条件出现则把一个通道考虑为可写的。

       事件驱动              I/O             最好为使用             fconfigure
       命令配置成非阻塞模式的通道工作。在阻塞模式下,如果你给它的数据比底层文件或数据可接受的多,则
       puts    命令将阻塞,而如果你读的数据比已咀急负玫亩啵getsread
       命令将阻塞;在命令阻塞时不处理事件。在非阻塞模式下,putsreadgets从不阻塞。参见这些单独命令的文档来得到关于它们如何处理阻塞和非阻塞通道的信息。

       给一个文件事件的脚本在调用fileevent
       命令的解释器的全局的层次上执行(在任何                               Tcl
       过程的上下文之外)。如果在执行脚本期间发生了错误则使用           bgerror
       机制来报告错误。额外的,如果一个事件处理器曾-
       返回错误则删除它;目的是防止缺陷很多的处理器导致无限鸦贰

 CREDITS
       fileevent  基于由 Mark Diekhans 建立的 addinput  命令。

 SEE ALSO
       bgerror(n), fconfigure(n), gets(n), puts(n), read(n)

 KEYWORDS
       asynchronous  I/O,  blocking,  channel,  event  handler,   nonblocking,
       readable, script, writable.

[[2001/08/13

 Linux man:
       http://cmpp.linuxforum.net