std::basic_string<CharT,Traits,Allocator>::swap — cppreference.com

Материал из cppreference.com

`void swap( basic_string& other );`		(до C++17)
`void swap( basic_string& other ) noexcept(/* смотрите ниже */);`		(начиная с C++17) (до C++20)
`constexpr void swap( basic_string& other ) noexcept(/* смотрите ниже */);`		(начиная с C++20)

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

Поведение не определено, если Allocator не распространяется при обмене и аллокаторы *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 << "Перед swap:\n"
                 "a = " << a << "\n"
                 "b = " << b << "\n\n";
    
    a.swap(b);
    
    std::cout << "После swap:\n"
                 "a = " << a << "\n"
                 "b = " << b << '\n';
}

Вывод:

Перед swap:
a = AAA
b = BBBB

После swap:
a = BBBB
b = AAA

Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

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

Смотрите также

	меняет местами значения двух объектов (шаблон функции) [править]
	меняет местами два диапазона элементов (шаблон функции) [править]
	обменивает содержимое (public функция-элемент `std::basic_string_view<CharT,Traits>`) [править]

Категории: