std::basic_ios<CharT,Traits>::rdbuf

std::basic_streambuf<CharT, Traits>* rdbuf() const;	(1)
std::basic_streambuf<CharT, Traits>* rdbuf( std::basic_streambuf<CharT, Traits>* sb );	(2)

Управляет связанным буфером потока.

1) Возвращает связанный буфер потока. Если связанного буфера потока нет, возвращает нулевой указатель.

2) Устанавливает связанный буфер потока в sb. Состояние ошибки очищается вызовом clear(). Возвращает связанный буфер потока до операции. Если связанного буфера потока нет, возвращает нулевой указатель.

Параметры

буфер потока для связывания

Возвращаемое значение

Связанный буфер потока или нулевой указатель, если связанного буфера потока не было.

Исключения

Может вызывать реализацией-определенные исключения.

Пример

#include <iostream>
#include <sstream>
 
int main()
{
    std::ostringstream local;
    auto cout_buff = std::cout.rdbuf(); // save pointer to std::cout buffer
 
    std::cout.rdbuf(local.rdbuf()); // substitute internal std::cout buffer with
        // buffer of 'local' object
 
    // now std::cout work with 'local' buffer
    // you don't see this message
    std::cout << "some message";
 
    // go back to old buffer
    std::cout.rdbuf(cout_buff);
 
    // you will see this message
    std::cout << "back to default buffer\n";
 
    // print 'local' content
    std::cout << "local content: " << local.str() << "\n";
}

Вывод:

back to default buffer
local content: some message

См. также

set_rdbuf

заменяет rdbuf без очистки его состояния ошибки
(защищенный член-функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/io/basic_ios/rdbuf