Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://en.cppreference.com/w/cpp/language/../error/../language/../io/basic_stringbuf/str.html below:

std::basic_stringbuf<CharT,Traits,Allocator>::str - cppreference.com

template< class StringViewLike >
void str( const StringViewLike& t );

Gets and sets the underlying string.

In the descriptions below, buf and mode are exposition-only data members of *this.

Creates and returns a

object containing a copy of this

's underlying character sequence. For input-only streams, the returned string contains the characters from the range

. For input/output or output-only streams, contains the characters from

to the last character in the sequence regardless of

and

.

The member character sequence in a buffer open for writing can be over-allocated for efficiency purposes. In that case, only the initialized characters are returned: these characters are the ones that were obtained from the string argument of the constructor, the string argument of the most recent call to a setter overload of str(), or from a write operation. A typical implementation that uses over-allocation maintains a high-watermark pointer to track the end of the initialized part of the buffer and this overload returns the characters from pbase() to the high-watermark pointer.

Equivalent to return std::basic_string<CharT, Traits, Allocator>(view(), get_allocator());.

This overload participates in overload resolution only if

meets the requirements of

.

Creates a

object as if by move constructing it from

's underlying character sequence in

.

may need to be adjusted to contain the same content as in

at first. After that, sets

to empty and calls

, then returns the

object.

Replaces the underlying character sequence as if by

, then calls

.

5) Same as (4), except the type of s's allocator is not Allocator.

This overload participates in overload resolution only if

is

.

Replaces the underlying character sequence as if by

, then calls

.

Implicitly converts

to a string view

as if by

, then replaces the underlying character sequence as if by

, then calls

.

4-7) (none)

This function is typically accessed through std::basic_istringstream::str(), std::basic_ostringstream::str(), or 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";
}

Output:

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"

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4