std::basic_stringbuf<CharT,Traits,Allocator>::swap
From cppreference.com
< cpp | io | basic stringbuf
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Input/output library
Print functions (C++23)
Buffers
(C++23)
(C++98/26*)
(C++20)
Streams
Abstractions
File I/O
String I/O
Array I/O
(C++23)
(C++23)
(C++23)
(C++98/26*)
(C++98/26*)
(C++98/26*)
Synchronized Output
(C++20)
Types
Error category interface
(C++11)
(C++11)
std::basic_stringbuf
Public member functions
(C++11)
basic_stringbuf::swap
(C++11)
(C++20)
(C++20)
Protected member functions
Non-member functions
(C++11)
Exposition-only member functions
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 the allocators of *this and other are unequal.
[edit] Parameters
rhs
-
another
basic_stringbuf
[edit] Return value
(none)
[edit] Exceptions
May throw implementation-defined exceptions.
(since C++11)(until C++20)
noexcept specification:
(since C++20)noexcept(std::allocator_traits <Allocator>::propagate_on_container_swap::value
|| std::allocator_traits <Allocator>::is_always_equal::value)
|| std::allocator_traits <Allocator>::is_always_equal::value)
[edit] Notes
This function is called automatically when swapping std::stringstream objects. It is rarely necessary to call it directly.
[edit] Example
Run this code
#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"; }
Output:
Before swap: one = "one", two = "two". After swap: one = "two", two = "one".