advance

通过位置指定数目的增加迭代器。

template<class InputIterator, class Distance>
   void advance(
      InputIterator& _InIt, 
      Distance _Off
   );

参数

• _InIt
  将增加，并且必须满足输入迭代的要求的迭代器。

• _Off
  转换成迭代器的差异类型，并指定数目有所增加迭代器位置的整型将高级。

备注

该范围高级必须通过非奇，其中迭代器必须dereferenceable或过去末尾。

如果 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 Samples)

标准模板库