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

void swap( basic_string& other );		(до C++17)
void swap( basic_string& other ) noexcept(/* see below */);		(с C++17) (до C++20)
constexpr void swap( basic_string& other ) noexcept(/* see below */);		(с C++20)

Обменивает содержимое строки с содержимым other. Все итераторы и ссылки могут быть недействительными.

Поведение не определено, если Allocator не распространяется на операцию swap, а аллокаторы *this и other не равны.

(с C++11)

Параметры

other

строка, с которой происходит обмен содержимым

Возвращаемое значение

(нет)

Сложность

Постоянная.

Исключения

Исключения не выбрасываются.

(до C++11)

Исключения могут быть выброшены только в случае неопределенного поведения (см. выше).

Если исключение выброшено по любой причине, эта функция не имеет эффекта (сильная гарантия исключительной безопасности).

(с C++11)

noexcept спецификация:

noexcept(std::allocator_traits<Allocator>::propagate_on_container_swap::value ||
 std::allocator_traits<Allocator>::is_always_equal::value)

(с C++17)

Пример

#include <iostream>
#include <string>
 
int main() 
{
    std::string a = "AAA";
    std::string b = "BBBB";
 
    std::cout << "Before swap:\n"
                 "a = " << a << "\n"
                 "b = " << b << "\n\n";
 
    a.swap(b);
 
    std::cout << "After swap:\n"
                 "a = " << a << "\n"
                 "b = " << b << '\n';
}

Вывод:

Before swap:
a = AAA
b = BBBB
 
After swap:
a = BBBB
b = AAA

Отчеты об ошибках

Следующие отчеты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

DR	Применён к	Поведение, как опубликовано	Правильное поведение
LWG 403	C++98	`swap()` могло выбросить исключение	исключение не выбрасывается
LWG 535	C++98	обмен строками не сохранял порядок символов	порядок также сохраняется

См. также

swap	обменивает значения двух объектов (шаблон функции)
swap_ranges	обменивает два диапазона элементов (шаблон функции)
swap	обменивает содержимое (публичный член-функция `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