Tcl Built-In Commands                                   flush(1T)





NAME
     flush - Flush buffered output for a channel

SYNOPSIS
     flush channelId



DESCRIPTION
     Flushes any output that has been buffered for channelId.

     ChannelId must be an identifier for an open channel such  as  
     a  Tcl standard channel (stdout or stderr), the return value  
     from an invocation of open or socket, or  the  result  of  a  
     channel  creation  command provided by a Tcl extension.  The  
     channel must have been opened for writing.

     If the channel is in blocking  mode  the  command  does  not
     return until all the buffered output has been flushed to the
     channel. If the channel is in nonblocking mode, the  command
     may  return before all buffered output has been flushed; the
     remainder will be flushed in the background as fast  as  the
     underlying file or device is able to absorb it.

EXAMPLE
     Prompt for the user to type some information in on the  con-
     sole:
          puts -nonewline "Please type your name: "
          flush stdout
          gets stdin name
          puts "Hello there, $name!"


SEE ALSO
     file(1T), open(1T), socket(1T), TclStandardChannels(3TCL)


KEYWORDS
     blocking, buffer, channel, flush, nonblocking, output

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:










Tcl                     Last change: 7.5                        1






Tcl Built-In Commands                                   flush(1T)



     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWTcl        
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for Tcl is available on http:/opensolaris.org.













































Tcl                     Last change: 7.5                        2