名称

fseek, ftell, rewind  −  ストリームの位置の再設定

形式

#include <stdio.h>

fseek(stream, offset, ptrname)
FILE ∗stream;
long offset;

long ftell(stream)
FILE ∗stream;

rewind(stream)

解説

fseek は、 stream 上の次の入力/出力操作の位置を設定します。 新しい位置は、 ptrname の値が 0 または 1、2 であるかによって、 ファイルの先頭、現在位置、終わりのうちの いずれかから符号付きの offset バイト分だけ離れたところになります。

fseek は ungetc(3S) の効果を無効にします。

ftell は、 指定した stream に接続されたファイルの、 ストリーム上での現在の先頭位置からのオフセット値を返します。 オフセットは、 UNIX上ではバイト単位で測られます。 他のシステムでは、 全くあてはまらない場合があり、 fseek 用の offset を得るための、 安全確実な唯一の方法です。

rewind(stream) は fseek(stream, 0L, 0)と同じです。

関連事項

lseek(2), fopen(3S)

診断

シークが正しくない場合には、 fseek は −1 を返します。 そうでなければ、 ゼロを返します。

NEWS-OSRelease 4.1C