std::basic_fstream<CharT,Traits>::open

 

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)

 

std::basic_fstream

メンバ関数

basic_fstream::basic_fstream

basic_fstream::operator= (C++11)

basic_fstream::swap (C++11)

basic_fstream::rdbuf

basic_fstream::native_handle (C++26)

ファイル操作

basic_fstream::is_open

basic_fstream::open

basic_fstream::close

非メンバ関数

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

 

void open( const char* filename,            std::ios_base::openmode mode                = std::ios_base::in | std::ios_base::out );	(1)
void open( const std::filesystem::path::value_type* filename,            std::ios_base::openmode mode                = std::ios_base::in | std::ios_base::out );	(2)	(C++17以降)
void open( const std::string& filename,            std::ios_base::openmode mode                = std::ios_base::in | std::ios_base::out );	(3)	(C++11以降)
void open( const std::filesystem::path& filename,            std::ios_base::openmode mode                = std::ios_base::in | std::ios_base::out );	(4)	(C++17以降)

指定されたファイル名 filename を持つファイルをファイルストリームに関連付けて開きます。

成功時には clear() を呼び出します。失敗時には setstate(failbit) を呼び出します。

1,2) 実質的に rdbuf()->open(filename, mode) を呼び出します（その呼び出しの効果の詳細については、std::basic_filebuf::open を参照してください）。オーバーロード (2) は、std::filesystem::path::value_type が char ではない場合にのみ提供されます。(C++17以降)

3,4) 実質的に (1,2) を open(filename.c_str(), mode) で呼び出すかのように処理します。

パラメータ

filename	-	開くファイルの名前
モード	-	ストリームのオープンモードを指定します。これは BitmaskType であり、以下の定数が定義されています。 Constant 説明 app 書き込みごとにストリームの末尾にシークします。 2進 バイナリモードで開きます。 in 読み取り用に開きます。 out 書き込み用に開きます。 trunc 開くときにストリームの内容を破棄します。 ate 開いてすぐにストリームの末尾にシークします。 noreplace (C++23) 排他モードで開きます。

戻り値

(なし)

例

このコードを実行

#include <fstream>
#include <iostream>
#include <string>
 
int main()
{
    std::string filename = "example.123";
 
    std::fstream fs;
    fs.open(filename);
 
    if (!fs.is_open())
    {
        fs.clear();
        fs.open(filename, std::ios::out); // create file
        fs.close();
        fs.open(filename);
    }
 
    std::cout << std::boolalpha;
    std::cout << "fs.is_open() = " << fs.is_open() << '\n';
    std::cout << "fs.good() = " << fs.good() << '\n';
}

不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 22	C++98	正常なオープン時にエラー状態がどのように変化するかが不明確であった	エラー状態は変更されない
LWG 409	C++98	正常なオープン時にエラー状態が変更されなかった	クリアされる
LWG 460	C++98	オーバーロード (1) の mode のデフォルト引数 が欠落していました（シノプシスには存在します）。	追加された

関連項目

is_open	ストリームに関連付けられたファイルがあるかチェックする (public member function)
close	関連付けられたファイルを閉じる (public member function)
open	ファイルをオープンし、関連付けられた文字シーケンスとして設定します。 (std::basic_filebuf<CharT,Traits> のメンバ関数)