最終更新日時(UTC):
が更新

履歴 編集

function template
<iterator>

std::prev

namespace std {
  template <class BidirectionalIterator>
  BidirectionalIterator prev(BidirectionalIterator x,
                             typename std::iterator_traits<BidirectionalIterator>::difference_type n = 1); // C++11

  template <class BidirectionalIterator>
  constexpr BidirectionalIterator prev(BidirectionalIterator x,
                             typename std::iterator_traits<BidirectionalIterator>::difference_type n = 1); // C++17
}

概要

n回後方に進めたイテレータを返す。

advance()と違い、引数として渡されたイテレータへの参照を書き換えるのではなく、n回後方に進んだイテレータのコピーを返す。

効果

advance(x, -n);
return x;

戻り値

引数として渡されたイテレータをn回後方に進めたイテレータのコピー

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

int main()
{
  std::vector<int> v = {3, 1, 4, 5, 2};

  {
    decltype(v)::iterator it = std::prev(v.end()); // イテレータを1回逆に進める
    std::cout << *it << std::endl;
  }
  {
    decltype(v)::iterator it = std::prev(v.end(), 2); // イテレータを2回逆に進める
    std::cout << *it << std::endl;
  }
}

出力

2
5

バージョン

言語

  • C++11

処理系

関連項目

名前 説明
next() n回前方に進めたイテレータを返す
advance() n回イテレータを進める

参照