advance
Incrementa un iteratore da un determinato numero di posizioni.
template<class InputIterator, class Distance>
void advance(
InputIterator& _InIt,
Distance _Off
);
Parametri
_InIt
Un iteratore che deve essere incrementato e che deve soddisfare i requisiti per un iteratore di input._Off
Un tipo integrale che è convertibile nel tipo di differenza dell'iteratore e che specifica il numero di incrementare la posizione dell'iteratore sia far avanzare l'oggetto.
Note
L'intervallo avanzata tramite deve essere non statica, dove gli iteratori devono essere dereferenceable o passati alla fine.
Se InputIterator soddisfi i requisiti per un tipo bidirezionale iteratori, quindi _Off può essere negativo.Se InputIterator è un input o un tipo in avanti iteratori, _Off deve essere non negativo.
La funzione di avanzamento di complessità costante in InputIterator soddisfi i requisiti per un iteratore di accesso casuale, in caso contrario, ha complessità lineare e pertanto è potenzialmente dispendiosa.
Esempio
// 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;
}
Requisiti
intestazione: <iterator>
Spazio dei nomi: deviazione standard