advance

依位置的指定數目遞增 Iterator。

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

參數

• _InIt
  要加入，而且必須符合輸入 Iterator 之需求的 Iterator。

• _Off
  轉換為 Iterator 的差異型別，並指定將數目 Iterator 的位置的整數類資料型別要向前移。

備註

這個範圍的進階必須透過非奇，其中 Iterator 必須 dereferenceable 或過去結束。

如果 InputIterator 內容雙向 Iterator 的需求類型，則 _Off 可能是負數。如果 InputIterator 是輸入或向前 Iterator 型別， _Off 為負值。

，當 InputIterator 滿足隨機存取 Iterator 時，就必須有事先函式具有常數的複雜度，否則，它會線性複雜，因此可能會耗用相當多的資源。

範例

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

標準樣板程式庫