総合手引 | セクション 3 | English | Deutsch | オプション |
#include <stdio.h>
#include <sys/types.h>
ftell() 関数は、 stream が指すストリームのファイル位置インジケータの 現在の値を入手します。
rewind() 関数は、 stream が指すストリームのファイル位置インジケータを ファイルの最初に設定します。これは、 ストリームのエラーインジケータがクリアされること ( clearerr(3) を参照) を除けば、以下と同じ結果になります。
(void)fseek(stream, 0L, SEEK_SET)
fseeko() 関数は fseek() と同様ですが、 引数には long の代わりに off_t をとります。 同様に ftello() 関数は ftell() と同じですが、 off_t を返します。
fgetpos() 関数と fsetpos() 関数は、( whence を SEEK_SET に設定した ) ftell() や fseek() と同じインタフェースで、ファイルオフセットの現在の値を pos が参照するオブジェクトから設定したり、 pos が参照するオブジェクトに保存したりします。 一部の ( UNIX 以外の) システムでは、 "fpos_t" オブジェクトが複合オブジェクトであるかもしれないので、 移植性を保ちながらテキストストリームの位置を 変更するためには、このルーチンに依るしかないこともあります。
The fgetpos, fseek, fseekoand fsetpos functions return the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.
成功して終了すると、 ftell() および ftello() は現在のオフセットを返します。それ以外の場合は -1 が返され、 グローバル変数 errno が設定されてエラーを示します。
[EBADF] | |
指定された stream が、シークできるストリームではありません。 | |
[EINVAL] | |
fseek() の whence 引数が、 SEEK_SET, SEEK_END, SEEK_CUR のどれでもありません。 | |
[EOVERFLOW] | |
ftell() を実行した結果のファイルのオフセットが long 型のオブジェクトでは正しく表現できない値となりました。 | |
fgetpos(), fseek(), fseeko(), fsetpos(), ftell(), ftello() 関数が失敗した時には、 ルーチン fflush(3), fstat(2), lseek(2), malloc(3) について示しているエラーが errno に設定されていることもあります。
fseeko() と ftello() 関数は、 Version 2 of the Single UNIX Specification に適合しています。
FSEEK (3) | March 5, 1999 |
総合手引 | セクション 3 | English | Deutsch | オプション |
このマニュアルページサービスについてのご意見は Ben Bullock にお知らせください。 Privacy policy.
“ | The most important thing in the programming language is the name. A language will not succeed without a good name. I have recently invented a very good name and now I am looking for a suitable language. | ” |
— Donald Knuth |