close
Espaços nominais
Variantes
    Ações

      std::next

      De cppreference.com
      Image

      This page has been machine-translated from the English version of the wiki using Google Translate.

      The translation may contain errors and awkward wording. Hover over text to see the original version. You can help to fix errors and improve the translation. For instructions click here.

      Click here for the English version of this page

      <metanoindex/>

       
      C++
       
      Biblioteca Iterator
      Primitivas iterador
      Original:
      Iterator primitives
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      Adaptadores de iterador
      Original:
      Iterator adaptors
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      Iteradores fluxo
      Original:
      Stream iterators
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      Operações iterador
      Original:
      Iterator operations
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      (C++11)
      (C++11)
      Variar de acesso
      Original:
      Range access
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      (C++11)
      (C++11)
       
      <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: 

      3 4

      Veja também

      (C++11)
      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]