advance
Zvýší o určený počet pozic iterace.
template<class InputIterator, class Distance>
void advance(
InputIterator& _InIt,
Distance _Off
);
Parametry
_InIt
Iterace, být zvýšen a který musí splňovat požadavky pro vstupní iterace._Off
Převést na typ rozdíl iteraci a který určuje počet kroků integrálního typu je poloha iterace pokročilé.
Poznámky
Rozsah rozšířené prostřednictvím musí být nonsingular, kde u iterátorů musí být dereferenceable nebo v minulosti do konce.
Pokud InputIterator splňuje požadavky pro obousměrný typ iterace, pak _Off může být záporná.Pokud InputIterator je typ iterační vstupní nebo předat dál, _Off musí být nezáporná.
Záloha funkce má konstantní složitosti při InputIterator splňuje požadavky pro náhodný přístup iterace; jinak byl lineární složitost a tak je potenciálně nákladné.
Příklad
// 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;
}
Požadavky
Záhlaví: <iterator>
Obor názvů: std