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

 

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_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

Protected member functions

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 [virtual]	関連付けられた入力シーケンスから取得領域に文字を読み込む (std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数)
underflow [virtual]	入力シーケンスで利用可能な次の文字を返す (std::basic_stringbuf<CharT,Traits,Allocator>の仮想保護メンバー関数)
underflow [virtual]	入力シーケンスから文字を読み取りますが、次のポインタは進めません。 (std::strstreambufの仮想保護メンバー関数)
uflow [virtual]	関連ファイルを読み込み、取得領域の次ポインタを進めます (仮想保護メンバ関数)
overflow [virtual]	ファイルバッファの格納領域から、関連付けられたファイルへ文字を書き込みます。 (virtual protected member function)
sgetc	シーケンスを進めずに、入力シーケンスから1文字を読み取る (std::basic_streambuf<CharT,Traits> の public メンバ関数)