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 |
(since C++11) |
Parameters
| rhs | - | another basic_stringbuf
|
Return value
(none)
Exceptions
|
May throw implementation-defined exceptions. |
(since C++11) (until C++20) |
noexcept specification:
noexcept(std::allocator_traits<Allocator>::propagate_on_container_swap::value || std::allocator_traits<Allocator>::is_always_equal::value) |
(since C++20) |
Notes
This function is called automatically when swapping std::stringstream objects. It is rarely necessary to call it directly.
Example
#include <iomanip>
#include <iostream>
#include <sstream>
#include <string>
int main()
{
std::istringstream one("one");
std::ostringstream two("two");
std::cout << "Before swap: one = " << std::quoted(one.str())
<< ", two = " << std::quoted(two.str()) << ".\n";
one.rdbuf()->swap(*two.rdbuf());
std::cout << "After swap: one = " << std::quoted(one.str())
<< ", two = " << std::quoted(two.str()) << ".\n";
}Before swap: one = "one", two = "two".
After 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>) |
Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.