std::fseek

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

入出力ライブラリ

I/Oマニピュレータ

出力関数 (C++23)

C形式I/O

バッファ

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

ストリーム

抽象化

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

ファイルI/O

basic_ifstream

basic_ofstream

basic_fstream

文字列I/O

basic_istringstream

basic_ostringstream

basic_stringstream

配列I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同期出力

basic_osyncstream (C++20)

型

streamoff

streamsize

fpos

エラーカテゴリインターフェース

iostream_category (C++11)

io_errc (C++11)

 

C形式I/O

型とオブジェクト
FILE fpos_t	stdinstdoutstderr
関数
ファイルアクセス fopen freopen fclose fflush fwide setbuf setvbuf 直接入出力 fread fwrite 非書式化入出力 fgetcgetc fgets fputcputc fputs getchar gets (C++14まで) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc 書式付き入力 scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	書式付き出力 printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf ファイルポジショニング ftell fgetpos fseek fsetpos rewind エラーハンドリング clearerr feof ferror perror ファイル操作 remove rename tmpfile tmpnam

 

ヘッダ<cstdio>で定義
int fseek( std::FILE* stream, long offset, int origin );

ファイルストリーム stream のファイル位置指示器を設定します。

ストリーム stream がバイナリモードで開かれている場合、新しい位置は、origin が SEEK_SET の場合はファイルの先頭から offset バイト、origin が SEEK_CUR の場合は現在のファイル位置から offset バイト、origin が SEEK_END の場合はファイルの末尾から offset バイトになります。バイナリストリームは、特にヌルバイトが追加で出力される場合、SEEK_END をサポートする必要はありません。

ストリーム stream がテキストモードで開かれている場合、offset でサポートされる値はゼロ（これはどの origin とも機能します）と、同じファイルに関連付けられたストリームに対して以前に行われた std::ftell の呼び出しによって返された値（これは origin が SEEK_SET の場合のみ機能します）のみです。

ストリーム stream がワイド指向の場合、テキストストリームとバイナリストリームの両方の制限が適用されます（std::ftell の結果は SEEK_SET で許可され、ゼロオフセットは SEEK_SET および SEEK_CUR から許可されますが、SEEK_END からは許可されません）。

ファイル位置指示器を変更するのに加えて、fseek は std::ungetc の効果を取り消し、該当する場合はファイル終了ステータスをクリアします。

読み取りまたは書き込みエラーが発生した場合、ストリームのエラー指示器（std::ferror）が設定され、ファイル位置は影響を受けません。

パラメータ

stream	-	変更するファイルストリーム
offset	-	origin を基準にして位置をシフトする文字数
origin	-	offset が加算される位置。以下のいずれかの値を指定できます: SEEK_SET、SEEK_CUR、SEEK_END

戻り値

成功した場合は ​0​、それ以外の場合は非ゼロの値。

注記

ワイドストリームで末尾以外の位置にシークした後、次に出力関数を呼び出すと、ファイルの残りの部分が未定義になる可能性があります。たとえば、異なる長さのマルチバイトシーケンスを出力することによって。

POSIX は、ファイルの既存の末尾を超えてシークすることを許可します。このシーク後に書き込みが行われた場合、ギャップからの読み取りは 0 バイトを返します。ファイルシステムによってサポートされている場合、これは *スパースファイル* を作成します。

POSIX はまた、fseek が書き込まれていないデータがある場合、最初に fflush を実行することを要求します（ただし、シフト状態が復元されるかどうかは実装定義です）。標準 C++ ファイルストリームは、フラッシュとアンシフトの両方を保証します: std::basic_filebuf::seekoff。

POSIX は、fseek がエラー時に -1 を返し、エラーを示すために errno を設定することを指定しています。

Windows では、2 GiB より大きいファイルを扱うには _fseeki64 を使用できます。

例

このコードを実行

#include <cassert>
#include <cstdio>
#include <cstdint>
#include <fstream>
#include <vector>
 
int main()
{
    std::ofstream("dummy.nfo") << "8 bytes\n"; // create the file
 
    std::FILE* fp = std::fopen("dummy.nfo", "rb");
    assert(fp);
 
    std::fseek(fp, 0, SEEK_END); // seek to end
    const std::size_t filesize = std::ftell(fp);
    std::vector<std::uint8_t> buffer(filesize);
 
    std::fseek(fp, 0, SEEK_SET); // seek to start
    std::fread(buffer.data(), sizeof(std::uint8_t), buffer.size(), fp);
 
    std::fclose(fp);
    std::printf("I've read %zi bytes\n", filesize);
}

実行結果の例

I've read 8 bytes

関連項目

fsetpos	ファイル位置指示子をファイル内の特定の場所に移動する (関数)
fgetpos	ファイル位置指示子を取得する (関数)
ftell	現在のファイル位置指示子を返す (関数)
rewind	ファイル位置指示子をファイルの先頭に移動する (関数)
C ドキュメント for fseek