std::next

Template:cpp/iterator/sidebar Template:ddcl list begin <tr class="t-dsc-header">

<td>

Defined in header <iterator>

</td>

<td></td> <td></td> </tr> <tr class="t-dcl ">

<td >

template< class ForwardIterator >

ForwardIterator next( ForwardIterator it,

                      typename std::iterator_traits<ForwardIterator>::difference_type n = 1);

</td>

<td class="t-dcl-nopad"> </td> <td > (since C++11) </td> </tr> Template:ddcl list end

Return the Template:cppth successor of iterator Template:cpp.

Equivalent to Template:cpp, that is, advances a copy of the iterator it.

Parameters

it	-	forward iterator
n	-	number of elements by which a copy of Template:cpp should be advanced.

Return value

The Template:cppth successor of iterator Template:cpp.

Example

Run this code

#include <iostream>
#include <iterator>
#include <vector>
 
int main() 
{
    std::vector<int> v{ 3, 1, 4 };
 
    auto it = v.begin();
 
    auto nx = std::next(it, 2);
 
    std::cout << *it << ' ' << *nx << '\n';
}

Output:

3 4

See also

Template:cpp/iterator/dcl list prevTemplate:cpp/iterator/dcl list advance