next.md

next

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

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

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

• iterator_traits[link iterator_traits.md]

概要

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

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

効果

advance(x, n);
return x;

• advance[link advance.md]

戻り値

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

例

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

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

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

• std::next[color ff0000]

出力

1
4

バージョン

言語

• C++11

処理系

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

関連項目

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

参照

• boost::next() - Boost Utility Library
• N2246 2 of the least crazy ideas for the standard library in C++0x
• LWG Issue 2353. std::next is over-constrained
• P0031R0 A Proposal to Add Constexpr Modifiers to reverse_iterator, move_iterator, array and Range Access