op_decrement.md

operator--

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

move_iterator& operator--();             // (1) C++11
constexpr move_iterator& operator--();   // (1) C++17

move_iterator operator--(int);           // (2) C++11
constexpr move_iterator operator--(int); // (2) C++17
move_iterator operator--(int) = default; // (2) C++29

概要

イテレータをデクリメントする。

効果

• 前置デクリメント operator--()：

--base();
return *this;

• base[link base.md]

• 後置デクリメント operator--(int)：

move_iterator tmp = *this;
--base();
return tmp;

• base[link base.md]

備考

• (2) : C++29で、後置インクリメント・デクリメント演算のdefault定義を使用した= default定義へ規定が変更された。動作は変わらない

例

#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; // ひとつ逆に進める
  std::unique_ptr<int> p = *it;

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

• v.emplace_back[link /reference/vector/vector/emplace_back.md]
• std::make_move_iterator[link /reference/iterator/make_move_iterator.md]

出力

4

バージョン

言語

• C++11

処理系

• Clang: ??
• GCC: 4.6.1 [mark verified]
• Visual C++: ??

参照

• P0031R0 A Proposal to Add Constexpr Modifiers to reverse_iterator, move_iterator, array and Range Access
• P3785R1 Library Wording Changes for Defaulted Postfix Increment and Decrement Operations
  • C++29で、後置演算子の規定が= default定義へ書き換えられた