avançar
Aumenta um iterador por um número especificado de posições.
template<class InputIterator, class Distance>
void advance(
InputIterator& InIt,
Distance Off
);
Parâmetros
InIt
O iterador que deverá ser incrementado e atender aos requisitos de um iterador de entrada.Off
Um tipo integral que pode ser convertido no tipo de diferença do iterador e que especifica o número de incrementos a ser avançado na posição do iterador.
Comentários
O intervalo avançado não deve ser singular, onde os iteradores devem ser desreferenciados ou passar do fim.
Se o InputIterator atender aos requisitos de um tipo de iterador bidirecional, Off poderá ser negativo. Se InputIterator for um tipo de iterador de avanço ou entrada, Off não deverá ser negativo.
A função de avanço tem complexidade constante quando InputIterator atende aos requisitos de um iterador de acesso aleatório. Caso contrário, terá complexidade linear e, portanto, será potencialmente caro.
Exemplo
// 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
Cabeçalho: <iterator>
Namespace: std