shift.md

shift

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

ValOrProxy<T> shift(int n) const;

• ValOrProxy[italic]

概要

要素の位置をシフトする。

戻り値

• nが正の値である場合、n個分だけ要素を前(0番目に向かう方向)に移動する。
• nが負の値である場合、n個分だけ要素を後ろ(size()に向かう方向)に移動する。

移動したことによって範囲外になった要素の値はなくなる。移動したことによって使用されなくなった要素の値は0で埋められる。

備考

• 戻り値の型 ValOrProxy は、valarray、あるいは、その代理となる型である。
  <valarray> の概要も参照のこと。

例

#include <iostream>
#include <valarray>

template <class T>
void print(const char* name, const std::valarray<T>& va)
{
  std::cout << name << " : {";
  bool first = true;

  for (const T& x : va) {
    if (first) {
      first = false;
    }
    else {
      std::cout << ',';
    }
    std::cout << x;
  }
  std::cout << "}" << std::endl;
}

int main()
{
  const std::valarray<int> va = {1, 2, 3, 4, 5};

  const std::valarray<int> left_shift_result = va.shift(3);
  print("left_shift_result", left_shift_result);

  const std::valarray<int> right_shift_result = va.shift(-3);
  print("right_shift_result", right_shift_result);
}

• shift[color ff0000]

出力

left_shift_result : {4,5,0,0,0}
right_shift_result : {0,0,0,1,2}