hpux man page for tell

Query: tell

OS: hpux

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

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

__________________________________________________________________________________________________________________________________________________

NAME
tell - Return current access position for an open channel SYNOPSIS
tell channelId _________________________________________________________________ DESCRIPTION
Returns an integer string giving the current access position in channelId. This value returned is a byte offset that can be passed to seek in order to set the channel to a particular position. Note that this value is in terms of bytes, not characters like read. The value returned is -1 for channels that do not support seeking. 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. EXAMPLE
Read a line from a file channel only if it starts with foobar: # Save the offset in case we need to undo the read... set offset [tell $chan] if {[read $chan 6] eq "foobar"} { gets $chan line } else { set line {} # Undo the read... seek $chan $offset } SEE ALSO
file(n), open(n), close(n), gets(n), seek(n), Tcl_StandardChannels(3) KEYWORDS
access position, channel, seeking Tcl 8.1 tell(n)
Related Man Pages
seek(n) - centos
tell(3tcl) - debian
seek(n) - opendarwin
tell(3) - linux
seek(10) - php
Similar Topics in the Unix Linux Community
Awk: Can anyone tell me why this doesn't work?
Theft of Intellectual Property Going On
script to tell whether there exists directory or not
Intelligent Script to Insert Records in Database Table
Clone 1 Hard disk fromIBM Intellipoint server with AIX 5.x