FSEEK

Section: C Library Functions (3)
索引 jman

BSD mandoc

索引

名称

fgetpos fseek fseeko fsetpos ftell ftello rewind - ストリームの位置変更

索引

ライブラリ

Lb libc

索引

書式

In stdio.h Ft int Fn fseek FILE *stream long offset int whence Ft long Fn ftell FILE *stream Ft void Fn rewind FILE *stream Ft int Fn fgetpos FILE *stream fpos_t *pos Ft int Fn fsetpos FILE *stream const fpos_t *pos In sys/types.h Ft int Fn fseeko FILE *stream off_t offset int whence Ft off_t Fn ftello FILE *stream

索引

解説

Fn fseek 関数は、 Fa stream が指すストリームのファイル位置インジケータを設定します。新しい位置はバイト単位で計測され、 Fa whence で指定された位置に Fa offset バイトを足すことで得られます。 Fa whence が SEEK_SET SEEK_CUR SEEK_END に設定されている場合、オフセットは、それぞれ、ファイルの最初、インジケータの現在位置、ファイルの最後からの相対位置になります。 Fn fseek 関数の呼び出しで問題が発生しない場合は、ストリームの end-of-file 指示子がクリアされ、そのストリームに対する ungetc(3) 関数の効果は取り消されます。

Fn ftell 関数は、 Fa stream が指すストリームのファイル位置インジケータの現在の値を入手します。

Fn rewind 関数は、 Fa stream が指すストリームのファイル位置インジケータをファイルの最初に設定します。これは、ストリームのエラーインジケータがクリアされること ( clearerr(3) を参照) を除けば、以下と同じ結果になります。

(void)fseek(stream, 0L, SEEK_SET)

Fn fseeko 関数は Fn fseek と同様ですが、引数には Fa long の代わりに Fa off_t をとります。同様に Fn ftello 関数は Fn ftell と同じですが、 Fa off_t を返します。

Fn fgetpos 関数と Fn fsetpos 関数は、( whence を SEEK_SET に設定した ) Fn ftell や Fn fseek と同じインタフェースで、ファイルオフセットの現在の値を Fa pos が参照するオブジェクトから設定したり、 Fa pos が参照するオブジェクトに保存したりします。一部の (UNIX 以外の ) システムでは、 ``Fa fpos_t '' オブジェクトが複合オブジェクトであるかもしれないので、移植性を保ちながらテキストストリームの位置を変更するためには、このルーチンに依るしかないこともあります。

索引

戻り値

Fn rewind 関数は値を返しません。

Rv -std fgetpos fseek fseeko fsetpos

成功して終了すると、 Fn ftell および Fn ftello は現在のオフセットを返します。それ以外の場合は -1 が返され、グローバル変数 errno が設定されてエラーを示します。

索引

エラー

Bq Er EBADF: 指定された Fa stream が、シークできるストリームではありません。
Bq Er EINVAL: Fn fseek の Fa whence 引数が、 SEEK_SET SEEK_END SEEK_CUR のどれでもありません。
Bq Er EOVERFLOW: Fn ftell を実行した結果のファイルのオフセットが long 型のオブジェクトでは正しく表現できない値となりました。

Fn fgetpos , Fn fseek , Fn fseeko , Fn fsetpos , Fn ftell , Fn ftello 関数が失敗した時には、ルーチン fflush(3), fstat(2), lseek(2), malloc(3) について示しているエラーが errno に設定されていることもあります。

索引

規格

Fn fgetpos , Fn fsetpos , Fn fseek , Fn ftell , Fn rewind 関数は、 St -isoC に適合しています。

Fn fseeko と Fn ftello 関数は、 St -susv2 に適合しています。

索引

jman

Time: 07:07:05 GMT, January 12, 2009

FSEEK

名称

ライブラリ

書式

解説

戻り値

エラー

関連項目

規格

Index