op_minus_assign.md

operator-=

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

move_iterator& operator-=(difference_type n);           // C++11
constexpr move_iterator& operator-=(difference_type n); // C++17

概要

イテレータ自身をn回逆に進める。

効果

current -= n;

※currentは、メンバ変数として保持しているアダプト元のイテレータ変数

戻り値

return *this;

例

#include <iostream>
#include <vector>
#include <memory>
#include <iterator>

int main()
{
  std::vector<std::unique_ptr<int>> v;
  for (int i = 0; i < 5; ++i)
    v.emplace_back(new int(i));

  auto it = std::make_move_iterator(v.end());
  it -= 2;
  std::unique_ptr<int> p = *it;

  std::cout << *p << std::endl;
}

• it -= 2[color ff0000]
• v.emplace_back[link /reference/vector/vector/emplace_back.md]
• std::make_move_iterator[link /reference/iterator/make_move_iterator.md]

出力

3

バージョン

言語

• C++11

処理系

• Clang: ??
• GCC:
• GCC, C++11 mode: 4.6.1
• ICC: ??
• Visual C++: ??

参照

• P0031R0 A Proposal to Add Constexpr Modifiers to reverse_iterator, move_iterator, array and Range Access