## Tcl8.6.17/Tk8.6.17 Documentation > Tcl Commands > seek

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

### NAME

seek — 開いた通信路の為の利用位置を変更する Change the access position for an open channel

### 構文 SYNOPSIS

seek channelId offset ?origin?

### 説明 DESCRIPTION

channelId の為の現在の利用位置を変更する｡ Changes the current access position for channelId.

channelId は､Tcl 標準通信路(stdin か stdout か stderr)､又は､ open や socket の起動からの返り値､又は､Tcl 拡張によってもたらされた命令が作成した通信路の返り値でなければならない｡(訳註:stderr<-strout) ChannelId must be an identifier for an open channel such as a Tcl standard channel (stdin, stdout, or stdout), the return value from an invocation of open or socket, or the result of a channel creation command provided by a Tcl extension.

offset と origin 引数は channelId に対して次回に読み書きが起る位置である｡offset は整数でなければならない(負数でもよいが)､又､ origin は次の中の一つでなければならない: The offset and origin arguments specify the position at which the next read or write will occur for channelId. Offset must be an integer (which may be negative) and origin must be one of the following:

start
  新しい利用位置は基礎ファイル又は装置の開始位置から offset バイトになる｡ The new access position will be offset bytes from the start of the underlying file or device.

current
  新しい利用位置は､現在の利用位置から offset バイトになる;負の offset は利用位置を基礎ファイル又は装置の後方へ動かす｡ The new access position will be offset bytes from the current access position; a negative offset moves the access position backwards in the underlying file or device.

end
  新しい利用位置は､ファイル又は装置の末尾から offset バイトになる｡負の offset は利用位置をファイル末尾の前方に置き､正の offset は利用位置をファイル末尾の後方に置く｡ The new access position will be offset bytes from the end of the file or device. A negative offset places the access position before the end of file, and a positive offset places the access position after the end of file.

origin 引数の省略時値は start である｡ The origin argument defaults to start.

この命令は､命令が制御から戻る前に､たとえ通信路が非同期方法であっても､通信路の全ての出力緩衝域を掃い出す｡又､どの様な緩衝域も未読の入力も遺棄する｡この命令は空文字を返す｡基礎ファイル又は装置がファイル位置捜索に対応していない通信路に適用すると不都合が生じる｡ The command flushes all buffered output for the channel before the command returns, even if the channel is in non-blocking mode. It also discards any buffered and unread input. This command returns an empty string. An error occurs if this command is applied to channels whose underlying file or device does not support seeking.

註意すべきは､ offset 値はバイトの偏寄であり､文字の偏寄ではない｡ seek 命令も tell 命令も文字ではなくバイト単位で操作する､この点で read とは違う｡ Note that offset values are byte offsets, not character offsets. Both seek and tell operate in terms of bytes, not characters, unlike read.

### 用例 EXAMPLES

ファイルを二度読む: Read a file twice:

    set f [open file.txt]
    set data1 [read $f]
    seek $f 0
    set data2 [read $f]
    close $f
    # ファイルが更新されてなければ$data1==$data2である
    # $data1 eq $data2 if the file wasn't updated

ファイルから末尾の１０バイトを読む: Read the last 10 bytes from a file:

    set f [open file.data]
    # 二進データでは動作が保障されているが
    # 他の文字符号系では失敗するかも...
    # This is guaranteed to work with binary data but
    # may fail with other encodings...
    fconfigure $f -translation binary
    seek $f -10 end
    set data [read $f 10]
    close $f

### SEE ALSO

file, open, close, gets, tell, Tcl_StandardChannels

### KEYWORDS

access position, file, seek
Copyright © 1993 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.