名前空間
変種
操作

std::basic_streambuf::sputbackc

提供: cppreference.com
< cpp‎ | io‎ | basic streambuf
 
 
入出力ライブラリ
入出力マニピュレータ
Cスタイルの入出力
バッファ
(C++98で非推奨)
ストリーム
抽象
ファイル入出力
文字列入出力
配列入出力
(C++98で非推奨)
(C++98で非推奨)
(C++98で非推奨)
同期化出力
エラーカテゴリインタフェース
(C++11)
 
 
int_type sputbackc( char_type c );

get 領域に文字を戻します。

get 領域の putback 位置が利用可能 (gptr() > eback()) であり、文字 cgptr() の1文字左の文字と等しければ (Traits::eq(c, gptr()[-1]) によって判定されます)、単に次ポインタ (gptr()) をデクリメントします。

そうでなければ、 get 領域を後退させるために、または get 領域と場合によっては紐付けられた文字シーケンスの両方を変更するために、 pbackfail(Traits::to_int_type(c)) を呼びます。

入出力ストリームの関数 basic_istream::putback はこの関数の観点で実装されます。

目次

[編集] 引数

c - 戻す文字

[編集] 戻り値

putback 位置が利用可能であれば、次ポインタの現在指している文字が Traits::to_int_type(*gptr())int_type に変換されて返されます。 この streambuf からの次の単一文字入力はこの文字を返します。

putback 位置が利用可能でなければ、 pbackfail() が返したものを返します。 失敗時は Traits::eof() になります。

[編集]

#include <iostream>
#include <sstream>
 
int main()
{
    std::stringstream s("abcdef"); // gptr() points to 'a' in "abcdef"
    std::cout << "Before putback, string holds " << s.str() << '\n';
    char c1 = s.get(); // c1 = 'a', gptr() now points to 'b' in "abcdef"
    char c2 = s.rdbuf()->sputbackc('z'); // same as s.putback('z')
                                         // gptr() now points to 'z' in "zbcdef"
    std::cout << "After putback, string holds " << s.str() << '\n';
    char c3 = s.get(); // c3 = 'z', gptr() now points to 'b' in "zbcdef"
    char c4 = s.get(); // c4 = 'b', gptr() now points to 'c' in "zbcdef"
    std::cout << c1 << c2 << c3 << c4 << '\n';
 
    s.rdbuf()->sputbackc('b');  // gptr() now points to 'b' in "zbcdef"
    s.rdbuf()->sputbackc('z');  // gptr() now points to 'z' in "zbcdef"
    int eof = s.rdbuf()->sputbackc('x');  // nothing to unget: pbackfail() fails
    if (eof == EOF)
        std::cout << "No room to putback after 'z'\n";
}

出力:

Before putback, string holds abcdef
After putback, string holds zbcdef
azzb
No room to putback after 'z'

[編集] 関連項目

入力シーケンスの次ポインタを1つ前に移動させます
(パブリックメンバ関数) [edit]
入力ストリームに文字を戻します
(std::basic_istreamのパブリックメンバ関数) [edit]