1mNAME0m
       fblocked  -  Test whether the last input operation exhausted all avail-
       able input

1mSYNOPSIS0m
       1mfblocked 4m22mchannelId0m


1mDESCRIPTION0m
       The 1mfblocked 22mcommand returns 1 if the most recent  input  operation  on
       4mchannelId24m  returned  less information than requested because all avail-
       able input was exhausted.  For example, if 1mgets 22mis invoked  when  there
       are  only  three  characters  available  for  input  and no end-of-line
       sequence, 1mgets 22mreturns  an  empty  string  and  a  subsequent  call  to
       1mfblocked 22mwill return 1.

       4mChannelId24m must be an identifier for an open channel such as a Tcl stan-
       dard channel (1mstdin22m, 1mstdout22m, or 1mstderr22m), the return value from an invo-
       cation  of  1mopen 22mor 1msocket22m, or the result of a channel creation command
       provided by a Tcl extension.

1mEXAMPLE0m
       The 1mfblocked  22mcommand  is  particularly  useful  when  writing  network
       servers,  as  it  allows you to write your code in a line-by-line style
       without preventing the servicing of other  connections.   This  can  be
       seen in this simple echo-service:

              # This is called whenever a new client connects to the server
              proc connect {chan host port} {
                  set clientName [format <%s:%d> $host $port]
                  puts "connection from $clientName"
                  fconfigure $chan -blocking 0 -buffering line
                  fileevent $chan readable [list echoLine $chan $clientName]
              }

              # This is called whenever either at least one byte of input
              # data is available, or the channel was closed by the client.
              proc echoLine {chan clientName} {
                  gets $chan line
                  if {[eof $chan]} {
                      puts "finishing connection from $clientName"
                      close $chan
                  } elseif {![1mfblocked 22m$chan]} {
                      # Didn't block waiting for end-of-line
                      puts "$clientName - $line"
                      puts $chan $line
                  }
              }

              # Create the server socket and enter the event-loop to wait
              # for incoming connections...
              socket -server connect 12345
              vwait forever


1mSEE ALSO0m
       gets(n), open(n), read(n), socket(n), Tcl_StandardChannels(3)


1mKEYWORDS0m
