advance

使迭代器递增指定数量的位置。

template<class InputIterator, class Distance>
    void advance(
        InputIterator& InIt, 
        Distance Off
   );

参数

• InIt
  要递增的迭代器，且必须满足输入迭代器的要求。

• Off
  可转换为迭代器的距离类型的整型值，用于指定要将迭代器位置前移的递增数。

备注

前移范围必须非奇数，这种情况下，迭代器必须可解引用或超过结尾。

如果 InputIterator 满足双向迭代器类型的要求，则 Off 可以是负数。 如果 InputIterator 为输入迭代器类型或向前迭代器类型，则 Off 必须为非负。

当 InputIterator 满足随机访问迭代器的要求时，前移函数具有固定复杂度；否则具有线性复杂度，因此可能会产生高昂的代价。

示例

// 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

请参见

参考

advance（STL 示例）

标准模板库