swap.md

swap

• string[meta header]
• std[meta namespace]
• basic_string[meta class]
• function[meta id-type]

void swap(basic_string& str);
void swap(basic_string& str) noexcept
  (allocator_traits<Allocator>::propagate_on_container_swap::value 
   || allocator_traits<Allocator>::is_always_equal::value);        // C++17

概要

他のbasic_stringオブジェクトとデータを入れ替える。

効果

*thisの内容をstrと交換する。

戻り値

なし

計算量

定数時間

例

#include <iostream>
#include <string>

int main()
{
  std::string a = "hello";
  std::string b = "world";

  a.swap(b);

  std::cout << a << std::endl;
  std::cout << b << std::endl;
}

• swap[color ff0000]

出力

world
hello

参照

• N4258 Cleaning-up noexcept in the Library, Rev 3
  • noexcept 追加の経緯となる提案文書