Difference between revisions of "cpp/iterator/next"
From cppreference.com
(+type reqs) |
(fmt) |
||
| Line 5: | Line 5: | ||
{{ddcl list item | notes={{mark since c++11}} | | {{ddcl list item | notes={{mark since c++11}} | | ||
template< class ForwardIt > | template< class ForwardIt > | ||
| − | ForwardIt next( ForwardIt it, typename std::iterator_traits<ForwardIt>::difference_type n {{=}} 1 ); | + | ForwardIt next( ForwardIt it, |
| + | typename std::iterator_traits<ForwardIt>::difference_type n {{=}} 1 ); | ||
}} | }} | ||
{{ddcl list end}} | {{ddcl list end}} | ||
Revision as of 11:32, 7 August 2012
Template:ddcl list begin <tr class="t-dsc-header">
<td>Defined in header
</td>
<iterator>
<td></td> <td></td> </tr> <tr class="t-dcl ">
<td >template< class ForwardIt >
</td>
ForwardIt next( ForwardIt it,
<td class="t-dcl-nopad"> </td> <td > (since C++11) </td> </tr> Template:ddcl list end
Return the nth successor of iterator it.
Contents |
Parameters
| it | - | an iterater' |
| n | - | number of elements to advance |
| Type requirements | ||
-ForwardIt must meet the requirements of LegacyForwardIterator.
| ||
Return value
The nth successor of iterator it.
Possible implementation
template<class ForwardIt> ForwardIt next(ForwardIt it, typename std::iterator_traits<ForwardIt>::difference_type n = 1) { std::advance(it, n); return it; } |
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
