advance
指定された位置の番号によって反復子をインクリメントします。
template<class InputIterator, class Distance>
void advance(
InputIterator& InIt,
Distance Off
);
パラメーター
InIt
インクリメントされる、入力反復子の要件を満たしている必要がある反復子。Off
反復子の差の型に変換可能で、反復子の位置を進めるインクリメントの数を指定する整数型。
解説
進む範囲は非特異である必要があり、反復子が逆参照可能であるか、末尾を超える必要があります。
InputIterator が双方向反復子型の要件を満たす場合、Off は負になる可能性があります。 InputIterator が入力反復子方または前方反復子型である場合、Off は負ではない必要があります。
InputIterator がランダム アクセス反復子の要件を満たす場合、advance 関数の複雑さは一定です。それ以外の場合、複雑さは線形的になり、潜在的にコストが高くなります。
使用例
// 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;
}
必要条件
ヘッダー:<iterator>
名前空間: std