NAME¶

std::basic_stringbuf::swap - std::basic_stringbuf::swap

Synopsis¶

void swap( basic_stringbuf& rhs ); (since C++11)
(until C++20)
void swap( basic_stringbuf& rhs ) noexcept(/* see below */); (since C++20)

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

The behavior is undefined if Allocator does not propagate on swap and (since C++11)
the allocators of *this and other are unequal.

Parameters¶

rhs - another basic_stringbuf

Return value¶

(none)

Exceptions¶

(since
May throw implementation-defined exceptions. C++11)
(until
C++20)
noexcept specification: (since
noexcept(std::allocator_traits<Allocator>::propagate_on_container_swap::value C++20)
|| std::allocator_traits<Allocator>::is_always_equal::value)

Notes¶

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

Example¶

// Run this code

#include <sstream>
#include <string>
#include <iostream>
#include <iomanip>

int main()
{
std::istringstream one("one");
std::ostringstream two("two");

std::cout << "Before swap, one = " << std::quoted( one.str() )
<< " two = " << quoted( two.str() ) << '\n';

one.rdbuf()->swap(*two.rdbuf());

std::cout << "After swap, one = " << quoted( one.str() )
<< " two = " << quoted( two.str() ) << '\n';
}

Output:¶

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

See also¶

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