std::basic_fstream

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

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

正規表現ライブラリ(C++11)

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

入出力ライブラリ

入出力マニピュレータ

Cスタイルの入出力

バッファ

basic_streambuf

basic_filebuf

basic_stringbuf

strstreambuf (C++98で非推奨)

basic_syncbuf (C++20)

ストリーム

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

ファイル入出力

basic_ifstream

basic_ofstream

basic_fstream

文字列入出力

basic_istringstream

basic_ostringstream

basic_stringstream

配列入出力

istrstream (C++98で非推奨)

ostrstream (C++98で非推奨)

strstream (C++98で非推奨)

同期化出力

basic_osyncstream (C++20)

型

streamoff

streamsize

fpos

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

iostream_category (C++11)

io_errc (C++11)

 

std::basic_fstream

メンバ関数

basic_fstream::basic_fstream

basic_fstream::operator= (C++11)

basic_fstream::swap (C++11)

basic_fstream::rdbuf

ファイル操作

basic_fstream::is_open

basic_fstream::open

basic_fstream::close

非メンバ関数

basic_fstream::swap(std::basic_fstream) (C++11)

 

ヘッダ <fstream> で定義
template<     class CharT,     class Traits =std::char_traits<CharT> >class basic_fstream :publicstd::basic_iostream<CharT, Traits>

クラステンプレート basic_fstream はファイルベースのストリームに対する高水準の入出力操作を実装します。 std::basic_iostream の高水準インタフェースを使用してファイルベースのストリームバッファ (std::basic_filebuf) とやりとりします。

std::basic_fstream の一般的な実装はひとつの非継承データメンバ、 std::basic_filebuf<CharT, Traits> のインスタンスのみを保持します。

継承図

一般的な文字型に対する2つの特殊化が定義されます。

ヘッダ <fstream> で定義
型	定義
fstream	basic_fstream<char>
wfstream	basic_fstream<wchar_t>

メンバ型

メンバ型	定義
char_type	CharT
traits_type	Traits。 Traits::char_type が CharT でない場合、プログラムは ill-formed です
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

メンバ関数

コンストラクタ	ファイルストリームを構築します (パブリックメンバ関数)
デストラクタ [仮想](暗黙に宣言)	basic_fstream および紐付けられているバッファを破棄し、ファイルを閉じます (仮想パブリックメンバ関数)
operator= (C++11)	ファイルストリームをムーブします (パブリックメンバ関数)
swap (C++11)	2つのファイルストリームを入れ替えます (パブリックメンバ関数)
rdbuf	ベースとなる生のファイルデバイスオブジェクトを返します (パブリックメンバ関数)
ファイル操作
is_open	ストリームが紐付けられているファイルを持っているかどうか調べます (パブリックメンバ関数)
open	ファイルを開き、それをストリームと紐付けます (パブリックメンバ関数)
close	紐付けられているファイルを閉じます (パブリックメンバ関数)

非メンバ関数

std::swap(std::basic_fstream) (C++11)

std::swap アルゴリズムの特殊化 (関数テンプレート)

std::basic_istream から継承

メンバ関数

書式付き入力
operator>>	書式付きデータを抽出します (std::basic_istream<CharT,Traits>のパブリックメンバ関数)
書式なし入力
get	文字を抽出します (std::basic_istream<CharT,Traits>のパブリックメンバ関数)
peek	次の文字を抽出せずに読み取ります (std::basic_istream<CharT,Traits>のパブリックメンバ関数)
unget	文字の抽出を取り消します (std::basic_istream<CharT,Traits>のパブリックメンバ関数)
putback	入力ストリームに文字を戻します (std::basic_istream<CharT,Traits>のパブリックメンバ関数)
getline	指定された文字が見つかるまで文字を抽出します (std::basic_istream<CharT,Traits>のパブリックメンバ関数)
ignore	指定された文字が見つかるまで文字を抽出して破棄します (std::basic_istream<CharT,Traits>のパブリックメンバ関数)
read	文字のブロックを抽出します (std::basic_istream<CharT,Traits>のパブリックメンバ関数)
readsome	すでに利用可能な文字のブロックを抽出します (std::basic_istream<CharT,Traits>のパブリックメンバ関数)
gcount	最後の書式なし入力操作によって抽出された文字数を返します (std::basic_istream<CharT,Traits>のパブリックメンバ関数)
位置設定
tellg	入力位置指示子を返します (std::basic_istream<CharT,Traits>のパブリックメンバ関数)
seekg	入力位置指示子を設定します (std::basic_istream<CharT,Traits>のパブリックメンバ関数)
その他
sync	ベースとなるストレージデバイスと同期します (std::basic_istream<CharT,Traits>のパブリックメンバ関数)

メンバクラス

sentry

入力操作用にストリームを準備するための基本ロジックを実装します (std::basic_istream<CharT,Traits>のパブリックメンバクラス)

std::basic_ostream から継承

メンバ関数

書式付き出力
operator<<	書式付きデータを挿入します (std::basic_ostream<CharT,Traits>のパブリックメンバ関数)
書式なし出力
put	文字を挿入します (std::basic_ostream<CharT,Traits>のパブリックメンバ関数)
write	文字のブロックを挿入します (std::basic_ostream<CharT,Traits>のパブリックメンバ関数)
位置設定
tellp	出力位置指示子を返します (std::basic_ostream<CharT,Traits>のパブリックメンバ関数)
seekp	出力位置指示子を設定します (std::basic_ostream<CharT,Traits>のパブリックメンバ関数)
その他
flush	ベースとなるストレージデバイスと同期します (std::basic_ostream<CharT,Traits>のパブリックメンバ関数)

メンバクラス

sentry

出力操作用にストリームを準備するための基本ロジックを実装します (std::basic_ostream<CharT,Traits>のパブリックメンバクラス)

std::basic_ios から継承

メンバ型

メンバ型	定義
char_type	CharT
traits_type	Traits
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

メンバ関数

状態関数
good	エラーが発生していない (すなわち入出力操作が使用可能) かどうか調べます (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
eof	ファイル終端に達したかどうか調べます (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
fail	エラーが発生したかどうか調べます (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
bad	回復不可能なエラーが発生したかどうか調べます (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
operator!	エラーが発生したかどうか調べます (fail() の同義語です) (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
operator void*operator bool (C++11未満)(C++11以上)	エラーが発生していないかどうか調べます (!fail() の同義語です) (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
rdstate	状態フラグを返します (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
setstate	状態フラグを設定します (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
clear	状態フラグを変更します (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
書式
copyfmt	書式情報をコピーします (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
fill	フィル文字を管理します (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
その他
exceptions	例外マスクを管理します (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
imbue	ロケールを設定します (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
rdbuf	紐付けられているストリームバッファを管理します (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
tie	結び付けられているストリームを管理します (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
narrow	文字をナロー化します (std::basic_ios<CharT,Traits>のパブリックメンバ関数)
widen	文字をワイド化します (std::basic_ios<CharT,Traits>のパブリックメンバ関数)

std::ios_base から継承

メンバ関数

書式
flags	書式フラグを管理します (std::ios_baseのパブリックメンバ関数)
setf	特定の書式フラグをセットします (std::ios_baseのパブリックメンバ関数)
unsetf	特定の書式フラグをクリアします (std::ios_baseのパブリックメンバ関数)
precision	浮動小数点操作の10進精度を管理します (std::ios_baseのパブリックメンバ関数)
width	フィールド幅を管理します (std::ios_baseのパブリックメンバ関数)
ロケール
imbue	ロケールを設定します (std::ios_baseのパブリックメンバ関数)
getloc	現在のロケールを返します (std::ios_baseのパブリックメンバ関数)
内部の拡張可能な配列
xalloc [静的]	pword() および iword() へのインデックスとして使用するのに安全な、プログラム全体で一意な整数を返します (std::ios_baseのパブリック静的メンバ関数)
iword	必要であればプライベートな記憶域をリサイズし、指定されたインデックスの long 要素にアクセスします (std::ios_baseのパブリックメンバ関数)
pword	必要であればプライベートな記憶域をリサイズし、指定されたインデックスの void* 要素にアクセスします (std::ios_baseのパブリックメンバ関数)
その他
register_callback	イベントのコールバック関数を登録します (std::ios_baseのパブリックメンバ関数)
sync_with_stdio [静的]	C++ と C の入出力ライブラリが相互運用可能であるかどうかを設定します (std::ios_baseのパブリック静的メンバ関数)
メンバクラス
failure	ストリームの例外 (std::ios_baseのパブリックメンバクラス)
Init	標準ストリームオブジェクトを初期化します (std::ios_baseのパブリックメンバクラス)

メンバ型および定数
型	説明
openmode	ストリームのオープンモードの型 以下の定数が定義されます。 定数 説明 app 各書き込み前にストリームの終端へシークします binary バイナリモードで開きます in 読み込み用に開きます out 書き込み用に開きます trunc 開くときにストリームの内容を破棄します ate 開いた直後にストリームの終端へシークします (typedef)
fmtflags	書式フラグの型 以下の定数が定義されます。 定数 説明 dec 整数の入出力に対して10進数を使用します。 std::dec を参照してください oct 整数の入出力に対して8進数を使用します。 std::oct を参照してください hex 整数の入出力に対して16進数を使用します。 std::hex を参照してください basefield dec|oct|hex。 マスク操作に便利です left 左詰め (フィル文字を右に追加します)。 std::left を参照してください right 右詰め (フィル文字を左に追加します)。 std::right を参照してください internal 内部詰め (フィル文字を内部の指定された位置に追加します)。 std::internal を参照してください adjustfield left|right|internal。 マスク操作に便利です scientific 科学表記を使用して浮動小数点型を生成します (fixed と組み合わせた場合は16進表記)。 std::scientific を参照してください fixed 固定表記を使用して浮動小数点型を生成します (scientific と組み合わせた場合は16進表記)。 std::fixed を参照してください floatfield scientific|fixed。 マスク操作に便利です boolalpha bool 型をアルファベット形式で挿入および抽出します。 std::boolalpha を参照してください showbase 整数の出力に対して数値の基数を表す接頭辞を生成し、金額の入出力に対して金額指示子を要求します。 std::showbase を参照してください showpoint 浮動小数点数の出力に対して小数点を無条件に生成します。 std::showpoint を参照してください showpos 非負の数値の出力に対して + 文字を出力します。 std::showpos を参照してください skipws 特定の入力操作の前に先行するホワイトスペースをスキップします。 std::skipws を参照してください unitbuf 各出力操作の後に出力をフラッシュします。 std::unitbuf を参照してください uppercase 特定の出力操作で特定の小文字を同等な大文字に置き換えます。 std::uppercase を参照してください (typedef)
iostate	ストリーム状態の型 以下の定数が定義されます。 定数 説明 goodbit エラーなし badbit 回復不可能なストリームのエラー failbit 入出力操作が失敗しました (書式エラーまたは抽出エラー) eofbit 紐付けられている入力シーケンスがファイル終端に達しました (typedef)
seekdir	シーク方向の型 以下の定数が定義されます。 定数 説明 beg ストリームの先頭 end ストリームの終端 cur ストリームの位置指示子の現在位置 (typedef)
event	イベントの種類を規定します (列挙)
event_callback	コールバック関数の型 (typedef)

関連項目

getline

入出力ストリームから文字列にデータを読み込みます (関数)

例

Run this code

#include <iostream>#include <fstream>#include <string>   int main(){std::string filename ="test.bin"; std::fstream s(filename, s.binary| s.trunc| s.in| s.out);if(!s.is_open()){std::cout<<"failed to open "<< filename <<'\n';}else{// writedouble d =3.14; s.write(reinterpret_cast<char*>(&d), sizeof d);// binary output s <<123<<"abc";// text output   // for fstream, this moves the file position pointer (both put and get) s.seekp(0);   // read s.read(reinterpret_cast<char*>(&d), sizeof d);// binary inputint n;std::string str;if(s >> n >> str)// text inputstd::cout<<"read back from file: "<< d <<' '<< n <<' '<< str <<'\n';}}

出力:

read back from file: 3.14 123 abc