std::basic_string<CharT,Traits,Allocator>::swap
void swap( basic_string& other ); |
(until C++17) | |
void swap( basic_string& other ) noexcept(/* see below */); |
(since C++17) (until C++20) |
|
constexpr void swap( basic_string& other ) noexcept(/* see below */); |
(since C++20) |
Exchanges the contents of the string with those of other. All iterators and references may be invalidated.
| The behavior is undefined if |
(since C++11) |
Parameters
| other | - | string to exchange the contents with |
Return value
(none).
Complexity
Constant.
Exceptionsnoexcept specification:
noexcept(std::allocator_traits<Allocator>::propagate_on_container_swap::value
|
(since C++17) |
Example
#include <string>
#include <iostream>
int main()
{
std::string a = "AAA";
std::string b = "BBB";
std::cout << "before swap" << '\n';
std::cout << "a: " << a << '\n';
std::cout << "b: " << b << '\n';
a.swap(b);
std::cout << "after swap" << '\n';
std::cout << "a: " << a << '\n';
std::cout << "b: " << b << '\n';
}
Output:
before swap a: AAA b: BBB after swap a: BBB b: AAA
See also
| swaps the values of two objects (function template) |
|
| swaps two ranges of elements (function template) |
|
|
(C++17)
|
swaps the contents (public member function of std::basic_string_view<CharT,Traits>) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/basic_string/swap
