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

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

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

Если std::allocator_traits<allocator_type>::propagate_on_container_swap::value имеет значение true, то аллокаторы обмениваются с помощью неквалифицированного вызова невключённой в класс функции swap. В противном случае они не обмениваются (и если get_allocator() != other.get_allocator(), поведение не определено).

(начиная с 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	обмен строк не сохранял порядок символов	порядок также сохраняется
LWG 2151 (P1148R0)	C++11	исключение не генерировалось в случае несовпадающих непередаваемых аллокаторов	в этом случае поведение не определено

См. также

swap	обменивает значения двух объектов (шаблон функции)
swap_ranges	обменивает два диапазона элементов (шаблон функции и объект-функция алгоритма)
ranges::swap_ranges (C++20)
swap	обменивает содержимое (открытая функция-член `std::basic_string_view<CharT,Traits>`)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/string/basic_string/swap