Seth Woolley's Man Viewer

tell(n) - tell, tell - Return current access position for an open channel - man n tell

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

tell(n)                      Tcl Built-In Commands                     tell(n)



NAME
       tell - Return current access(2,5) position for an open(2,3,n) channel

SYNOPSIS
       tell channelId


DESCRIPTION
       Returns  an  integer string(3,n) giving the current access(2,5) position in(1,8) chan-
       nelId.  This value returned is a byte offset that can be passed to seek
       in(1,8)  order  to set(7,n,1 builtins) the channel to a particular position.  Note that this
       value is in(1,8) terms of  bytes,  not  characters  like  read(2,n,1 builtins).   The  value
       returned is -1 for channels that do not support seeking.

       ChannelId must be an identifier for an open(2,3,n) channel such as a Tcl stan-
       dard channel (stdin, stdout, or stderr), the return value from an invo-
       cation  of  open(2,3,n) or socket(2,7,n), or the result of a channel creation command
       provided by a Tcl extension.


SEE ALSO
       file(1,n)(n), open(2,3,n)(n), close(2,7,n)(n), gets(3,n)(n), seek(n), Tcl_StandardChannels(3)


KEYWORDS
       access(2,5) position, channel, seeking



Tcl                                   8.1                              tell(n)

References for this manual (incoming links)