swap.md

swap

• array[meta header]
• std[meta namespace]
• array[meta class]
• function[meta id-type]
• cpp11[meta cpp]

void swap(array& other)
         noexcept(noexcept(swap(declval<T&>(), declval<T&>()))); // C++11

constexpr void swap(array& other)
         noexcept(noexcept(swap(declval<T&>(), declval<T&>()))); // C++20

• declval[link /reference/utility/declval.md]

概要

自身と他のarrayオブジェクトの値を入れ替える

効果

swap_ranges(begin(), end(), other.begin())

戻り値

なし

例外

arrayクラスの要素型Tに対するswap操作が例外を投げない場合、このswap関数は決して例外を投げない。

計算量

線形時間

備考

0要素の場合(N == 0)、noexcept(true)となる。

例

#include <iostream>
#include <array>

#include <string>
#include <algorithm> // std::for_each

template <class T, std::size_t N>
void print(const std::string& name, const std::array<T, N>& ar)
{
  std::cout << name << " : ";
  std::for_each(ar.begin(), ar.end(), [](const T& x) {
    std::cout << x << ' ';
  });
  std::cout << std::endl;
}

int main()
{
  std::array<int, 3> x = {1, 2, 3};
  std::array<int, 3> y = {4, 5, 6};

  x.swap(y);

  print("x", x);
  print("y", y);
}

• swap[color ff0000]

出力

x : 4 5 6 
y : 1 2 3 

バージョン

言語

• C++11

処理系

• Clang: ??
• GCC: 4.7.0 [mark verified]
• ICC: ??
• Visual C++: 2008 (std::tr1) [mark verified], 2010 [mark verified], 2012 [mark verified]

参照

• P1032R1 Misc constexpr bits