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

入力エリアに少なくとも1文字が利用可能であることを保証します（必要に応じて入力エリアへのポインタを更新し、該当する場合は入力シーケンスからさらにデータを読み込みます）。成功時にはその文字の値（ int_type に Traits :: to_int_type ( c ) で変換された値）を返し、失敗時には Traits :: eof ( ) を返します。

この関数は、新しく読み込まれたデータ（存在する場合）の位置を定義するために、 gptr 、 egptr および eback ポインタを更新する場合があります。失敗時には、関数は gptr ( ) == nullptr または gptr ( ) == egptr のいずれかが確実に成立するようにします。

基底クラスのバージョンの関数は何も行いません。派生クラスは、枯渇の場合に取得領域の更新を可能にするためにこの関数をオーバーライドする場合があります。

パラメータ

(なし)

戻り値

呼び出し成功後の get pointer が指す文字の値、またはそれ以外の場合は Traits :: eof ( ) 。

この関数の基底クラスバージョンは traits :: eof ( ) を返します。

注記

std::streambuf の公開関数は、 gptr ( ) == nullptr または gptr ( ) >= egptr ( ) の場合にのみ、この関数を呼び出します。

例

#include <iostream>
#include <sstream>
class null_filter_buf : public std::streambuf
{
    std::streambuf* src;
    char ch; // シングルバイトバッファ
protected:
    int underflow()
    {
        traits_type::int_type i;
        while ((i = src->sbumpc()) == '\0')
            ; // ゼロをスキップ
        if (!traits_type::eq_int_type(i, traits_type::eof()))
        {
            ch = traits_type::to_char_type(i);
            setg(&ch, &ch, &ch+1); // 1つの読み取り位置を利用可能にする
        }
        return i;
    }
public:
    null_filter_buf(std::streambuf* buf) : src(buf)
    {
        setg(&ch, &ch + 1, &ch + 1); // バッファは初期状態で満杯
    }
};
void filtered_read(std::istream& in)
{
    std::streambuf* orig = in.rdbuf();
    null_filter_buf buf(orig);
    in.rdbuf(&buf);
    for (char c; in.get(c);)
        std::cout << c;
    in.rdbuf(orig);
}
int main()
{
    char a[] = "This i\0s \0an e\0\0\0xample";
    std::istringstream in(std::string(std::begin(a), std::end(a)));
    filtered_read(in);
}

This is an example

関連項目