◐ Shell
clean mode source ↗

std::next - cppreference.com

De cppreference.com

<metanoindex/>

<tbody> </tbody>

Definido no cabeçalho

<iterator>

template< class ForwardIt > ForwardIt next( ForwardIt it, typename std::iterator_traits<ForwardIt>::difference_type n = 1 );

(desde C++11)

Retorne o sucessor de nth it iterador.

Original:

Return the nth successor of iterator it.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Parâmetros

it -

um iterater '

Original:

an iterater'

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

n -

número de elementos para avançar

Original:

number of elements to advance

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Type requirements
-ForwardIt must meet the requirements of ForwardIterator.

Valor de retorno

O sucessor de nth it iterador.

Original:

The nth successor of iterator it.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Possível implementação

template<class ForwardIt>
ForwardIt next(ForwardIt it, typename std::iterator_traits<ForwardIt>::difference_type n = 1)
{
    std::advance(it, n);
    return it;
}

Exemplo

#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';
}

Saída:

Veja também

decrementar um iterador

Original:

decrement an iterator

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.


(função) [edit]

avanços de um iterador por determinada distância

Original:

advances an iterator by given distance

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.


(função) [edit]