Namespaces
Variants
Views
Actions

std::swap(std::basic_string)

From cppreference.com
< cpp‎ | string‎ | basic string
 
 
 
std::basic_string
Non-member functions
swap(std::basic_string)
I/O
Comparison
(until C++20)(until C++20)(until C++20)(until C++20)(until C++20)(C++20)
Numeric conversion (C++11)
Deduction guides (C++17)
Helper classes
 
Defined in header <string>
template< class CharT, class Traits, class Alloc >

void swap( std::basic_string<CharT, Traits, Alloc> &lhs,

           std::basic_string<CharT, Traits, Alloc> &rhs );
(until 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 */);
(since C++17)
(until 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 */);
(since C++20)

Specializes the std::swap algorithm for std::basic_string. Swaps the contents of lhs and rhs. Equivalent to lhs.swap(rhs).

Contents

[edit] Parameters

lhs, rhs - strings whose contents to swap

[edit] Return value

(none)

[edit] Complexity

Constant.

Exceptions

noexcept specification:  
noexcept(noexcept(lhs.swap(rhs)))
(since C++17)

[edit] Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

DR Applied to Behavior as published Correct behavior
LWG 2064 C++11 non-member swap was noexcept and inconsistent with member swap noexcept removed

[edit] See also

swaps the contents
(public member function) [edit]