Пространства имён
Варианты
Действия

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

Материал из cppreference.com
< cpp‎ | string‎ | basic string
 
C++
Поддержка компилятором
Автономные и размещённые реализации
Язык
Стандартная библиотека
Заголовки стандартной библиотеки
Требования к именованию
Макросы тестирования функциональности (C++20)
Поддержка языка
Библиотека концептов (C++20)
Библиотека метапрограммирования (C++11)
Библиотека диагностики
Библиотека общих утилит
Библиотека строк
Библиотека контейнеров
Библиотека итераторов
Библиотека диапазонов (C++20)
Библиотека алгоритмов
Библиотека численных данных
Библиотека ввода/вывода
Библиотека локализаций
Регулярные выражения (C++11)
Атомарные операции (C++11)
Библиотека поддержки конкуренции (C++11)
Библиотека файловой системы (C++17)
Технические спецификации
Указатель символов
Внешние библиотеки
 
Строки
 
std::basic_string
Функции-элементы
(C++23)
Доступ к элементам
(DR*)
(DR*)
(C++17)
Итераторы
(DR*)
(DR*)
(DR*)
(DR*)
Ёмкость
(DR*)
Операции
(C++23)
(DR*)
(C++23)
(C++23)
(C++23)  
basic_string::swap
Поиск
(C++20)  
(C++20)
(C++23)
Константы
Правила вывода (C++17)
Функции, не являющиеся элементами
(C++14)
(C++20)(C++20)
Ввод/Вывод
Сравнение
(до C++20)(до C++20)(до C++20)(до C++20)(до C++20)(C++20)
Числовые преобразования
(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Вспомогательные классы
(C++11)  (C++11)(C++11)(C++11)(C++20)
(C++17)(C++17)(C++17)(C++17)(C++20)
 
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 замена строк не сохраняла порядок символов порядок также сохраняется

[править] Смотрите также

 меняет местами значения двух объектов
(шаблон функции) [править]
меняет местами два диапазона элементов
(шаблон функции) [править]
(C++17)
 обменивает содержимое
(public функция-элемент std::basic_string_view<CharT,Traits>) [править]
Источник — «https://ru.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/swap&oldid=63886»