std::swap(std::basic_string)

Определено в заголовочном файле <string>

Определено в заголовочном файле `<string>`
template< class CharT, class Traits, class Alloc > void swap( std::basic_string<CharT, Traits, Alloc>& lhs, std::basic_string<CharT, Traits, Alloc>& rhs );		(до C++17)
template< class CharT, class Traits, class Alloc > void swap( std::basic_string<CharT, Traits, Alloc>& lhs, std::basic_string<CharT, Traits, Alloc>& rhs ) noexcept(/* see below */);		(начиная с C++17) (constexpr начиная с C++20)

template< class CharT, class Traits, class Alloc >
void swap( std::basic_string<CharT, Traits, Alloc>& lhs,
           std::basic_string<CharT, Traits, Alloc>& rhs );

(до C++17)

template< class CharT, class Traits, class Alloc >
void swap( std::basic_string<CharT, Traits, Alloc>& lhs,
           std::basic_string<CharT, Traits, Alloc>& rhs ) noexcept(/* see below */);

(начиная с C++17)
(constexpr начиная с C++20)

Специализирует алгоритм std::swap для std::basic_string. Меняет местами содержимое lhs и rhs.

Эквивалентно lhs.swap(rhs).

Параметры

lhs, rhs

строки, содержимое которых нужно поменять местами

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

(нет)

Сложность

Постоянная.

Исключения

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

noexcept(noexcept(lhs.swap(rhs)))

(начиная с 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";

    std::swap(a, 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++.

Отчёт об ошибке	Применён к	Опубликованное поведение	Корректное поведение
LWG 2064	C++11	не являющаяся членом `swap` имела спецификацию noexcept, что не соответствовало функции-члену `swap`	noexcept удалена

См. также

swap	меняет местами содержимое (открытая функция-член)

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