std::basic_ofstream::basic_ofstream

(1) 預設建構函式

構造一個未與任何檔案關聯的basic_ofstream物件。
在內部，其basic_ostream基建構函式接收一個指向新構造的basic_filebuf物件（內部檔案流緩衝區）的指標。

(2) 初始化建構函式

構造一個basic_ofstream物件，它最初與由第一個引數（filename）標識的檔案關聯，並以mode指定的模式開啟。
在內部，其basic_ostream基建構函式接收一個指向新構造的basic_filebuf物件（內部檔案流緩衝區）的指標。然後，呼叫basic_filebuf::open並以filename和mode作為引數。
如果檔案無法開啟，則設定流的failbit標誌。

(3) 複製建構函式 (已刪除)

已刪除 (無複製建構函式)。

(4) 移動建構函式

獲取 x 的內容。
首先，該函式將它的基basic_ostream類從x移動構造，並將x的內部basic_filebuf物件移動構造為basic_filebuf物件，然後透過呼叫成員set_rdbuf將它們關聯起來。
x 處於未指定但有效的狀態。

引數

filename

代表要開啟的檔名的字串。
有關其格式和有效性的具體說明取決於庫實現和執行環境。

mode

描述檔案請求的輸入/輸出模式的標誌。
這是一個位掩碼成員型別 openmode 的物件，由以下成員常量的組合構成：

成員常量	代表	access
in	輸入	檔案以讀模式開啟：內部流緩衝區支援輸入操作。
下可用的型別 *	輸出	檔案以寫模式開啟：內部流緩衝區支援輸出操作。
binary	binary	操作以二進位制模式執行，而非文字模式。
ate	在末尾	輸出位置從檔案末尾開始。
app	append (追加)	所有輸出操作都在檔案末尾進行，追加到其現有內容。
trunc	truncate (截斷)	檔案開啟前存在的任何內容都將被丟棄。

這些標誌可以透過按位或運算子（|）組合。
* 對於basic_ofstream物件，out始終被設定（即使在引數mode中顯式未設定）。
請注意，儘管basic_ofstream是一個輸出流，但其內部basic_filebuf物件可能被設定為也支援輸入操作。

如果模式同時設定了 trunc 和 app，則開啟操作失敗。如果同時設定了 app 和 in，也會失敗。

如果模式同時設定了 trunc 和 app，則開啟操作失敗。

x

一個相同型別的basic_ofstream物件（具有相同的類模板引數charT和traits），其值被移動。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13

// ofstream constructor.
#include <fstream>      // std::ofstream

int main () {

  std::ofstream ofs ("test.txt", std::ofstream::out);

  ofs << "lorem ipsum";

  ofs.close();

  return 0;
}

資料競爭

異常安全

另見

basic_ofstream::open

開啟檔案 (公開成員函式)