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

From cppreference.com
< cpp‎ | io‎ | basic stringbuf
 
 
Input/output library
I/O manipulators
C-style I/O
Buffers
(deprecated in C++98)
Streams
Abstractions
File I/O
String I/O
Array I/O
(deprecated in C++98)
(deprecated in C++98)
(deprecated in C++98)
Synchronized Output
Types
Error category interface
(C++11)
 
 
void swap( std::basic_stringbuf& rhs )
(since C++11)

Swaps the state and the contents of *this and rhs.

Parameters

rhs - another basic_stringbuf

Return value

(none)

Notes

This function is called automatically when swapping std::stringstream objects, it is rarely necessary to call it directly.

Example

#include <sstream>
#include <string>
#include <iostream>
 
int main()
{
 
    std::istringstream one("one");
    std::ostringstream two("two");
 
    std::cout << "Before swap, one = \"" << one.str() << '"'
              << " two = \"" << two.str() << "\"\n";
 
    *one.rdbuf()->swap(*two.rdbuf());
 
    std::cout << "Before swap, one = \"" << one.str() << '"'
              << " two = \"" << two.str() << "\"\n";
}

Output:

Before swap, one = "one" two = "two"
Before swap, one = "two" two = "one"

See also

constructs a basic_stringbuf object
(public member function)
(C++11)
swaps two string streams
(public member function of std::basic_stringstream<CharT,Traits,Allocator>)