名称

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) と同じですが、値を返しません。 また、 fseek は EOF 表示 (feof(3S) 参照)だけをクリアしますが、 rewind は EOF 表示とエラー表示 (ferror(3S) 参照)の両方をクリアします。

関連事項

lseek(2), fopen(3S)

診断

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

NEWS-OSRelease 4.2.1R