opensolaris man page for eof

eof(1T) 						       Tcl Built-In Commands							   eof(1T)

__________________________________________________________________________________________________________________________________________________

NAME
       eof - Check for end of file condition on channel

SYNOPSIS
       eof channelId
_________________________________________________________________

DESCRIPTION
       Returns 1 if an end of file condition occurred during the most recent input operation on channelId (such as gets), 0 otherwise.

       ChannelId  must	be  an	identifier for an open channel such as a Tcl standard channel (stdin, 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.

EXAMPLES
       Read and print out the contents of a file line-by-line:
	      set f [open somefile.txt]
	      while {1} {
		  set line [gets $f]
		  if {[eof $f]} {
		      close $f
		      break
		  }
		  puts "Read line: $line"
	      }

       Read and print out the contents of a file by fixed-size records:
	      set f [open somefile.dat]
	      fconfigure $f -translation binary
	      set recordSize 40
	      while {1} {
		  set record [read $f $recordSize]
		  if {[eof $f]} {
		      close $f
		      break
		  }
		  puts "Read record: $record"
	      }

SEE ALSO
       file(1T), open(1T), close(1T), fblocked(1T), Tcl_StandardChannels(3TCL)

KEYWORDS
       channel, end of file

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTcl	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES
       Source for Tcl is available on http://opensolaris.org.

Tcl									7.5								   eof(1T)