std::basic_stringbuf<CharT,Traits,Allocator>:: str

Получает и устанавливает базовую строку.

В приведенных ниже описаниях, buf и mode являются демонстрационными членами данных объекта * this .

Последовательность символов-членов в буфере, открытом для записи, может быть перераспределена для повышения эффективности. В этом случае возвращаются только инициализированные символы : эти символы получены из строкового аргумента конструктора, строкового аргумента последнего вызова перегруженной функции-сеттера str() или из операции записи. Типичная реализация, использующая перераспределение, поддерживает указатель верхней границы для отслеживания конца инициализированной части буфера, и эта перегрузка возвращает символы от pbase() до указателя верхней границы.

Параметры

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

Примечания

Эта функция обычно доступна через std::basic_istringstream::str() , std::basic_ostringstream::str() , или std::basic_stringstream::str() .

Пример

#include <iostream>
#include <sstream>
int main()
{
    int n;
    std::istringstream in;  // could also use in("1 2")
    in.rdbuf()->str("1 2"); // set the get area
    in >> n;
    std::cout << "after reading the first int from \"1 2\", the int is " 
              << n << ", str() = \"" << in.rdbuf()->str() << "\"\n"; // or in.str()
    std::ostringstream out("1 2");
    out << 3;
    std::cout << "after writing the int '3' to output stream \"1 2\""
              << ", str() = \"" << out.str() << "\"\n";
    std::ostringstream ate("1 2", std::ios_base::ate); // C++11
    ate << 3;
    std::cout << "after writing the int '3' to append stream \"1 2\""
              << ", str() = \"" << ate.str() << "\"\n";
}

after reading the first int from "1 2", the int is 1, str() = "1 2"
after writing the int '3' to output stream "1 2", str() = "3 2"
after writing the int '3' to append stream "1 2", str() = "1 23"

Отчёты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

Смотрите также