advance

incrementa un iterador por un número especificado de posiciones.

template<class InputIterator, class Distance>
   void advance(
      InputIterator& _InIt, 
      Distance _Off
   );

Parámetros

• _InIt
  El iterador que debe incrementar y que debe satisfacer los requisitos para un iterador de la entrada.

• _Off
  Entero escribe que se puede convertir al tipo de diferencia de iterador y que especifica el número de incrementos la posición de iterador debe ser avanzado.

Comentarios

El intervalo avanzadas a través debe ser no unario, donde los iteradores deben ser dereferenceable o últimos el final.

Si InputIterator cumple los requisitos para un tipo bidireccional de iterador, después _Off puede ser negativo.Si InputIterator es una entrada o un tipo de iteradores hacia delante, _Off debe ser negativo.

La función advance tiene complejidad constante cuando InputIterator cumple los requisitos para un iterador de acceso aleatorio; si no, tiene complejidad lineal y lo que es potencialmente cara.

Ejemplo

// iterator_advance.cpp
// compile with: /EHsc
#include <iterator>
#include <list>
#include <iostream>

int main( )
{
   using namespace std;
   int i;

   list<int> L;
   for ( i = 1 ; i < 9 ; ++i )  
   {
      L.push_back ( i );
   }
   list <int>::iterator L_Iter, LPOS = L.begin ( );

   cout << "The list L is: ( ";
   for ( L_Iter = L.begin( ) ; L_Iter != L.end( ); L_Iter++)
      cout << *L_Iter << " ";
   cout << ")." << endl;
   
   cout << "The iterator LPOS initially points to the first element: "
        << *LPOS << "." << endl;

   advance ( LPOS , 4 );
   cout << "LPOS is advanced 4 steps forward to point"
        << " to the fifth element: "
        << *LPOS << "." << endl;

   advance ( LPOS , -3 );
   cout << "LPOS is moved 3 steps back to point to the "
        << "2nd element: " << *LPOS << "." << endl;
}

Requisitos

encabezado: <iterador>

espacio de nombres: std

Vea también

Referencia

advance (STL Samples)

Biblioteca de plantillas estándar