Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

eof (1t)

Name

eof - Check for end of file condition on channel

Synopsis

eof channelId

Description

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 stan-
       dard channel (stdin, stdout, or stderr), the return value from an invo-
       cation 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"
              }


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


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tcl-8    |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

SEE ALSO
       file(n), open(n), close(n), fblocked(n), Tcl_StandardChannels(3)

KEYWORDS
       channel, end of file



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source was downloaded from  http://prdownloads.sourceforge.net/tcl/tcl-
       core8.6.7-src.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.tcl.tk/.



Tcl                                   7.5                              eof(1t)