std::basic_filebuf<CharT,Traits>::overflow

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

輸入/輸出庫

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_filebuf

公開成員函式

basic_filebuf::basic_filebuf

basic_filebuf::~basic_filebuf

basic_filebuf::operator= (C++11)

basic_filebuf::swap (C++11)

basic_filebuf::native_handle (C++26)

basic_filebuf::is_open

basic_filebuf::open

basic_filebuf::close

受保護的成員函式

basic_filebuf::showmanyc

basic_filebuf::underflow

basic_filebuf::uflow

basic_filebuf::pbackfail

basic_filebuf::overflow

basic_filebuf::setbuf

basic_filebuf::seekoff

basic_filebuf::seekpos

basic_filebuf::sync

basic_filebuf::imbue

非成員函式

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

 

protected: virtual int_type overflow( int_type ch = Traits::eof() );

將寫入區的一些資料寫入關聯的字元序列（到檔案）。

行為與基類版本 std::basic_streambuf::overflow() 相同，除了“消費字元”的行為定義如下：

1) 首先，使用所注入區域設定的 std::codecvt::out 將字元轉換為外部（可能是多位元組）表示，儲存在一個臨時緩衝區中，如下所示：（XSIZE 是某個未指定的緩衝區大小）

const std::codecvt<CharT, char, typename Traits::state_type>& a_codecvt =
    std::use_facet<std::codecvt<CharT, char, typename Traits::state_type>>(getloc());
typename Traits::state_type state;
CharT* end;
char xbuf[XSIZE];
char* xbuf_end;
std::codecvt_base::result r =
    a_codecvt.out(state, pbase(), pptr(), end, xbuf, xbuf + XSIZE, xbuf_end);

2) 然後將緩衝區中所有完全轉換的字元寫入檔案。根據 r 的值，正式執行以下步驟：

r	操作
std::codecvt_base::ok	將 [xbuf, xbuf_end) 中的字元輸出到檔案，如果輸出失敗則失敗。此時，如果 pbase() != pptr() 和 pbase() == end 都為 true（這意味著 xbuf 不足以容納一個外部字元），則增加 XSIZE 並從頭開始重複。
std::codecvt_base::partial	將 [xbuf, xbuf_end) 中已轉換的外部字元輸出到檔案，並使用 [end, pptr()) 中剩餘未轉換的內部字元重複。如果輸出失敗，則失敗（不重複）。
std::codecvt_base::noconv	將 [pbase(), pptr()) 中的字元輸出到檔案。
std::codecvt_base::error	失敗。

如果關聯檔案未開啟（is_open() 返回 false），則輸出總是失敗。

3) 建立一個 可觀測的檢查點。

(C++26 起)

引數

ch

-

- 要儲存在放置區的字元

返回值

Traits::not_eof(ch) 表示成功，或 Traits::eof() 表示失敗。

注意

如果 a_codecvt.always_noconv() 返回 true，則可能跳過對 a_codecvt.out() 的呼叫。

參閱

overflow [virtual]	從放置區向關聯輸出序列寫入字元 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)
underflow [virtual]	從關聯檔案讀取 (虛保護成員函式)