名前

       fseeko, ftello - ファイル位置を探す/報告する

書式

       #include <stdio.h>

       int fseeko(FILE *stream, off_t offset, int whence);

       off_t ftello(FILE *stream);

   glibc 向けの機能検査マクロの要件 (feature_test_macros(7)  参照):

       fseeko(), ftello():
           _FILE_OFFSET_BITS == 64 || _POSIX_C_SOURCE >= 200112L
           (廃止予定のマクロ _LARGEFILE_SOURCE を指定しても動作する)

説明

       fseeko()   関数および ftello()  関数は、 それぞれ fseek(3)  および ftell(3) と同一の機能を
       持つ (fseek(3)  を見よ) が、ただし fseeko()  関数の offset 引数と  ftello()   の返り値が、
       long ではなく off_t になっている。

       いくつかのアーキテクチャーでは、  off_t  と  long の両方が 32 ビット型だが、 (「どの」ヘッ
       ダーファイルをインクルードするよりも前に) _FILE_OFFSET_BITS を値 64  で定義すると、  off_t
       が 64 ビット型になる。

返り値

       成功した場合、  fseeko()   は 0 を、 ftello()  は現在のオフセットを返す。 失敗した場合、-1
       を返し、 errno にエラーを示す値をセットする。

エラー

       fseek(3)  の「エラー」の節を参照。

バージョン

       これらの関数はバージョン 2.1 以降の glibc で利用可能である。

属性

       この節で使用されている用語の説明については、 attributes(7) を参照。

       ┌───────────────────┬───────────────┬─────────┐
       │インターフェース   │ 属性          │ 値      │
       ├───────────────────┼───────────────┼─────────┤
       │fseeko(), ftello() │ Thread safety │ MT-Safe │
       └───────────────────┴───────────────┴─────────┘

準拠

       POSIX.1-2001, POSIX.1-2008, SUSv2.

関連項目

       fseek(3)

この文書について

       この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの
       説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。

                                            2017-09-15                                  FSEEKO(3)