advance
Sai 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 devem ser incrementadas e que deve satisfazer os requisitos para um iterador de entrada._Off
Um tipo integral que seja conversível para o tipo da diferença de iterador e que especifica o número de incrementos a posição de iterador deve ser avançado.
Comentários
O intervalo avançar completamente deve ser nonsingular, onde iteradores devem ser dereferenceable ou passados para o final.
Se InputIterator satisfaz os requisitos para um iterador bidirecional tipo, então _Off pode ser negativo.Se InputIterator é uma entrada ou um tipo para frente de iterador, _Off . deve ser não-negativos
a função avançada tem a complexidade constante quando InputIterator satisfaz os requisitos para um iterador de acesso aleatório; caso contrário, tem a complexidade linear e portanto é potencialmente cara.
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