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) (до C++20)
template< class CharT, class Traits, class Alloc > constexpr void swap( std::basic_string<CharT, Traits, Alloc>& lhs, std::basic_string<CharT, Traits, Alloc>& rhs ) noexcept(/* see below */);		(с 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)
(до C++20)

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

(с 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++.

DR	Применено к	Поведение, как опубликовано	Корректное поведение
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/w/cpp/string/basic_string/swap2