Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/iterator/next"

From cppreference.com
< cpp‎ | iterator
m (example tweak: important to point out that it's by-value unlike advance())
m (c++11)
Line 3: Line 3:
 
{{ddcl list begin}}
 
{{ddcl list begin}}
 
{{ddcl list header | iterator}}
 
{{ddcl list header | iterator}}
{{ddcl list item |
+
{{ddcl list item | notes={{since c++11}} |
 
template< class ForwardIterator >
 
template< class ForwardIterator >
 
ForwardIterator next( ForwardIterator it,
 
ForwardIterator next( ForwardIterator it,

Revision as of 12:18, 2 January 2012

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 > Template: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.

Contents

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

Template:example cpp

See also

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