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

 

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 underflow()

將更多資料讀入輸入區。

行為與基類 std::basic_streambuf::underflow 類似，不同之處在於將資料從關聯的字元序列（檔案）讀入獲取區域時，首先將位元組從檔案讀入臨時緩衝區（根據需要分配），然後使用注入區域的 std::codecvt::in 將外部（通常是多位元組）表示形式轉換為內部形式，然後用於填充獲取區域。如果區域設定的 std::codecvt::always_noconv 返回 true，則可以跳過轉換。

引數

(無)

返回值

如果成功，返回 Traits::to_int_type(*gptr())（待定序列的第一個字元），否則返回 Traits::eof()。

示例

執行此程式碼

#include <fstream>
#include <iostream>
 
struct mybuf : std::filebuf
{
    int underflow()
    {
         std::cout << "Before underflow(): size of the get area is "
                   << egptr()-eback() << " with "
                   << egptr()-gptr() << " read positions available\n";
         int rc = std::filebuf::underflow();
         std::cout << "underflow() returns " << rc << ".\nAfter the call, "
                   << "size of the get area is "
                   << egptr()-eback() << " with "
                   << egptr()-gptr() << " read positions available\n";
        return rc;
    }
};
 
int main()
{
    mybuf buf;
    buf.open("test.txt", std::ios_base::in);
    std::istream stream(&buf);
    while (stream.get()) ;
}

可能的輸出

Before underflow(): size of the get area is 0 with 0 read positions available
underflow() returns 73.
After the call, size of the get area is 110 with 110 read positions available
Before underflow(): size of the get area is 110 with 0 read positions available
underflow() returns -1.
After the call, size of the get area is 0 with 0 read positions available

參閱

underflow [虛]	從關聯輸入序列中讀取字元到獲取區 (std::basic_streambuf<CharT,Traits> 的虛保護成員函式)
underflow [虛]	返回輸入序列中下一個可用的字元 (std::basic_stringbuf<CharT,Traits,Allocator> 的虛保護成員函式)
underflow [虛]	從輸入序列中讀取一個字元，但不推進下一個指標 (std::strstreambuf 的虛保護成員函式)
uflow [虛]	從關聯檔案讀取並推進獲取區域中的下一指標 (虛保護成員函式)
overflow [虛]	從放置區向關聯檔案寫入字元 (虛保護成員函式)
sgetc	從輸入序列中讀取一個字元而不推進序列 (std::basic_streambuf<CharT,Traits> 的公有成員函式)