std:: basic_ofstream

From cppreference.net

ヘッダーで定義 `<fstream>`
template < class CharT, class Traits = std:: char_traits < CharT > > class basic_ofstream : public std:: basic_ostream < CharT, Traits >

クラステンプレート basic_ofstream は、ファイルベースのストリームに対する高レベルな出力操作を実装します。これはファイルベースのストリームバッファ（ std::basic_filebuf ）を高レベルインターフェース（ std::basic_ostream ）と連携させます。

std::basic_ofstream の典型的な実装は、派生していないデータメンバを1つだけ保持します： std:: basic_filebuf < CharT, Traits > のインスタンスです。

継承図

一般的な文字型に対するいくつかのtypedefが提供されています：

定義済みヘッダー `<fstream>`
型	定義
`std::ofstream`	std :: basic_ofstream < char >
`std::wofstream`	std :: basic_ofstream < wchar_t >

メンバ型	定義
`char_type`	`CharT`
`traits_type`	`Traits` ; プログラムは、 `Traits::char_type` が `CharT` でない場合、不適格となる。
`int_type`	`Traits::int_type`
`pos_type`	`Traits::pos_type`
`off_type`	`Traits::off_type`
`native_handle_type` (C++26)	実装定義型であり、 TriviallyCopyable かつ `semiregular` である

メンバー関数

(constructor)	ファイルストリームを構築する (public member function)
(destructor) [virtual] (implicitly declared)	`basic_ofstream` と関連するバッファを破棄し、ファイルを閉じる (virtual public member function)
operator= (C++11)	ファイルストリームを移動する (public member function)
swap (C++11)	2つのファイルストリームを交換する (public member function)
rdbuf	基盤となる生のファイルデバイスオブジェクトを返す (public member function)
native_handle (C++26)	基盤となる実装定義のハンドルを返す (public member function)
ファイル操作
is_open	ストリームに関連付けられたファイルがあるかどうかをチェックする (public member function)
open	ファイルを開き、ストリームに関連付ける (public member function)
close	関連付けられたファイルを閉じる (public member function)

非メンバー関数

std::swap (std::basic_ofstream)

(C++11)

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

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	エラーが発生していないか（つまりI/O操作が利用可能か）をチェックする ( `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 bool	エラーが発生していないかどうかをチェックする（ `!` 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` のpublicメンバ関数)
setf	特定のフォーマットフラグを設定する ( `std::ios_base` のpublicメンバ関数)
unsetf	特定のフォーマットフラグをクリアする ( `std::ios_base` のpublicメンバ関数)
precision	浮動小数点演算の10進精度を管理する ( `std::ios_base` のpublicメンバ関数)
width	フィールド幅を管理する ( `std::ios_base` のpublicメンバ関数)
ロケール
imbue	ロケールを設定する ( `std::ios_base` のpublicメンバ関数)
getloc	現在のロケールを返す ( `std::ios_base` のpublicメンバ関数)
内部拡張可能配列
xalloc [static]	`pword()` および `iword()` のインデックスとして使用するのに安全な、プログラム全体で一意な整数を返す ( `std::ios_base` のpublic staticメンバ関数)
iword	必要に応じてプライベートストレージをリサイズし、指定されたインデックスの long 要素にアクセスする ( `std::ios_base` のpublicメンバ関数)
pword	必要に応じてプライベートストレージをリサイズし、指定されたインデックスの void * 要素にアクセスする ( `std::ios_base` のpublicメンバ関数)
その他
register_callback	イベントコールバック関数を登録する ( `std::ios_base` のpublicメンバ関数)
sync_with_stdio [static]	C++とCのI/Oライブラリが相互運用可能かどうかを設定する ( `std::ios_base` のpublic staticメンバ関数)
メンバクラス
failure	ストリーム例外 ( `std::ios_base` のpublicメンバクラス)
Init	標準ストリームオブジェクトを初期化する ( `std::ios_base` のpublicメンバクラス)

メンバー型と定数

型説明

openmode

ストリームオープンモード型

以下の定数も定義されています：

定数	説明
`app`	各書き込み前にストリームの終端へシーク
`binary`	バイナリモードでオープン
`in`	読み取り用にオープン
`out`	書き込み用にオープン
`trunc`	オープン時にストリームの内容を破棄
`ate`	オープン直後にストリームの終端へシーク
`noreplace` (C++23)	排他モードでオープン

(typedef)

fmtflags

書式フラグの型

以下の定数も定義されています：

定数	説明
`dec`	整数I/Oに10進基数を使用：参照 std::dec
`oct`	整数I/Oに8進基数を使用：参照 std::oct
`hex`	整数I/Oに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`	整数出力で数値基数を示す接頭辞を生成、通貨I/Oで通貨指示子を要求：参照 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)

注記

機能テストマクロ	値	標準	機能
`__cpp_lib_fstream_native_handle`	`202306L`	(C++26)	ネイティブハンドルサポート

例

このコードを実行

#include <fstream>
#include <iostream>
#include <string>
int main()
{
    std::string filename = "Test.b";
    {
        std::ofstream ostrm(filename, std::ios::binary);
        double d = 3.14;
        ostrm.write(reinterpret_cast<char*>(&d), sizeof d); // バイナリ出力
        ostrm << 123 << "abc" << '\n';                      // テキスト出力
    }
    // 読み戻し
    std::ifstream istrm(filename, std::ios::binary);
    double d;
    istrm.read(reinterpret_cast<char*>(&d), sizeof d);
    int n;
    std::string s;
    istrm >> n >> s;
    std::cout << " read back: " << d << ' ' << n << ' ' << s << '\n';
}

出力:

read back: 3.14 123 abc

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros (C++20)
Language support library
Concepts library (C++20)
Diagnostics library
Memory management library
Metaprogramming library (C++11)
General utilities library
Containers library
Iterators library
Ranges library (C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Technical specifications
Symbols index
External libraries

I/O manipulators
Print functions (C++23)
C-style I/O
Buffers
basic_streambuf
basic_filebuf
basic_stringbuf
basic_spanbuf (C++23)
strstreambuf ( C++98/26* )
basic_syncbuf (C++20)
Streams
Abstractions
ios_base
basic_ios
basic_istream
basic_ostream
basic_iostream
File I/O
basic_ifstream
basic_ofstream
basic_fstream
String I/O
basic_istringstream
basic_ostringstream
basic_stringstream
Array 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* )
Synchronized Output
basic_osyncstream (C++20)
Types
streamoff
streamsize
fpos
Error category interface
iostream_category (C++11)
io_errc (C++11)

Member functions
basic_ofstream::basic_ofstream
basic_ofstream::operator= (C++11)
basic_ofstream::swap (C++11)
basic_ofstream::rdbuf
basic_ofstream::native_handle (C++26)
File operations
basic_ofstream::is_open
basic_ofstream::open
basic_ofstream::close
Non-member functions
swap (std::basic_ofstream) (C++11)

cppreference.net

Namespaces

Variants

std:: basic_ofstream

目次

メンバー型

メンバー関数

ファイル操作

非メンバー関数

std:: basic_ostream から継承

メンバ関数

書式付き出力

書式なし出力

位置指定

その他

メンバクラス

std:: basic_ios から継承

メンバ型

メンバ関数

状態関数

書式設定

その他

std:: ios_base から継承

メンバー関数

フォーマット

ロケール

内部拡張可能配列

その他

メンバクラス

メンバー型と定数

注記

例