back_insert_iterator 類別

發行項
08/04/2024

描述滿足輸出迭代器需求的迭代器配接器。它在序列後端插入項目 (而不是覆寫)，因此其語意不同於 C++ 序列容器的迭代器所提供的覆寫語意。 back_insert_iterator 類別是根據容器的類型樣板化。

語法

template <class Container>
class back_insert_iterator;

參數

容器
容器的類型，其項目後端要由 back_insert_iterator 插入。

備註

容器必須符合是否可以在平攤常數時間將項目插入於序列結尾的後端插入序列需求。 deque 類別、list 類別和 vector 類別所定義的 C++ 標準程式庫序列容器提供需要的 push_back 成員函式且滿足這些需求。這三個容器和字串可能各自調整為搭配 back_insert_iterator使用。 back_insert_iterator 一定要以其容器初始化。

建構函式

建構函式	描述
back_insert_iterator	建構 `back_insert_iterator`，在容器的最後一個項目之後插入項目。

Typedefs

類型名稱	描述
container_type	類型，提供 `back_insert_iterator` 的容器。
reference	類型，提供 `back_insert_iterator` 的參考。

操作員

運算子	描述
operator*	取值運算子，用來實作輸出迭代器運算式 *`i` = `x` 以進行後端插入。
operator++	將 `back_insert_iterator` 遞增至可儲存值的下一個位置。
operator=	指派運算子，用來實作輸出迭代器運算式 *`i` = `x` 以進行後端插入。

需求

標頭： <反覆運算器>

命名空間：std

back_insert_iterator：：back_insert_iterator

建構 back_insert_iterator，在容器的最後一個項目之後插入項目。

explicit back_insert_iterator(Container& _Cont);

參數

_續
back_insert_iterator 要在其中插入元素的容器。

傳回值

參數容器的 back_insert_iterator。

範例

// back_insert_iterator_back_insert_iterator.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;
   int i;

   vector<int> vec;
   for ( i = 1 ; i < 4 ; ++i )
   {
      vec.push_back ( i );
   }

   vector <int>::iterator vIter;
   cout << "The initial vector vec is: ( ";
   for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++)
      cout << *vIter << " ";
   cout << ")." << endl;

   // Insertions with member function
   back_inserter ( vec ) = 40;
   back_inserter ( vec ) = 50;

   // Alternatively, insertions can be done with template function
   back_insert_iterator<vector<int> > backiter ( vec );
*backiter = 600;
   backiter++;
*backiter = 700;

   cout << "After the insertions, the vector vec is: ( ";
   for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++)
      cout << *vIter << " ";
   cout << ")." << endl;
}

The initial vector vec is: ( 1 2 3 ).
After the insertions, the vector vec is: ( 1 2 3 40 50 600 700 ).

back_insert_iterator：：container_type

類型，提供 back_insert_iterator 的容器。

typedef Container
container_type;

備註

此類型與範本參數 Container 同義。

範例

// back_insert_iterator_container_type.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;
   int i;

   vector<int> vec;
   for (i = 1 ; i < 4 ; ++i )
   {
      vec.push_back (  i );
   }

   vector <int>::iterator vIter;
   cout << "The original vector vec is: ( ";
   for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++)
      cout << *vIter << " ";
   cout << ")." << endl;

   back_insert_iterator<vector<int> >::container_type vec1 = vec;
   back_inserter ( vec1 ) = 40;

   cout << "After the insertion, the vector is: ( ";
   for ( vIter = vec1.begin ( ) ; vIter != vec1.end ( ); vIter++)
      cout << *vIter << " ";
   cout << ")." << endl;
}

The original vector vec is: ( 1 2 3 ).
After the insertion, the vector is: ( 1 2 3 40 ).

back_insert_iterator：：operator*

用來實作輸出反覆運算器表示式 * i = x 的取值運算符。

back_insert_iterator<Container>& operator*();

傳回值

插入容器後端之元素的參考。

備註

用來實作輸出反覆運算器表達式 *Iter = 值。如果 Iter 是尋址序列中元素的反覆運算器，則 *Iter = 值會以值取代該專案，而且不會變更序列中的元素總數。

範例

// back_insert_iterator_back_insert.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;
   int i;

   vector<int> vec;
   for (i = 1 ; i < 4 ; ++i )
   {
      vec.push_back ( i );
   }

   vector <int>::iterator vIter;
   cout << "The vector vec is: ( ";
   for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++)
      cout << *vIter << " ";
   cout << ")." << endl;

   back_insert_iterator<vector<int> > backiter ( vec );
*backiter = 10;
   backiter++;      // Increment to the next element
*backiter = 20;
   backiter++;

   cout << "After the insertions, the vector vec becomes: ( ";
   for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++)
      cout << *vIter << " ";
   cout << ")." << endl;
}

The vector vec is: ( 1 2 3 ).
After the insertions, the vector vec becomes: ( 1 2 3 10 20 ).

back_insert_iterator：：operator++

將 back_insert_iterator 遞增至可儲存值的下一個位置。

back_insert_iterator<Container>& operator++();
back_insert_iterator<Container> operator++(int);

傳回值

back_insert_iterator，定址可儲存值的下一個位置。

備註

preincrementation 和 postincrementation 運算子都會傳回相同的結果。

範例

// back_insert_iterator_op_incre.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;
   int i;

   vector<int> vec;
   for (i = 1 ; i < 3 ; ++i )
   {
      vec.push_back ( 10 * i );
   }

   vector <int>::iterator vIter;
   cout << "The vector vec is: ( ";
   for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++)
      cout << *vIter << " ";
   cout << ")." << endl;

   back_insert_iterator<vector<int> > backiter ( vec );
*backiter = 30;
   backiter++;      // Increment to the next element
*backiter = 40;
   backiter++;

   cout << "After the insertions, the vector vec becomes: ( ";
   for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++)
      cout << *vIter << " ";
   cout << ")." << endl;
}

The vector vec is: ( 10 20 ).
After the insertions, the vector vec becomes: ( 10 20 30 40 ).

back_insert_iterator：：operator=

將值附加或推送到容器後端。

back_insert_iterator<Container>& operator=(typename Container::const_reference val);
back_insert_iterator<Container>& operator=(typename Container::value_type&& val);

參數

val
要插入容器的值。

傳回值

插入容器後端之最後一個元素的參考。

備註

第一個成員運算子會評估 Container.push_back( val)，

然後傳回 *this。在第二個成員運算子會評估

container->push_back((typename Container::value_type&&)val),

然後傳回 *this。

範例

// back_insert_iterator_op_assign.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;
   int i;

   vector<int> vec;
   for (i = 1 ; i < 4 ; ++i )
   {
      vec.push_back ( i );
   }

   vector <int>::iterator vIter;
   cout << "The vector vec is: ( ";
   for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++)
      cout << *vIter << " ";
   cout << ")." << endl;

   back_insert_iterator<vector<int> > backiter ( vec );
*backiter = 10;
   backiter++;      // Increment to the next element
*backiter = 20;
   backiter++;

   cout << "After the insertions, the vector vec becomes: ( ";
   for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++)
      cout << *vIter << " ";
   cout << ")." << endl;
}

back_insert_iterator：：reference

類型，提供 back_insert_iterator 的參考。

typedef typename Container::reference reference;

備註

此類型描述相關聯容器所控制序列之元素的參考。

範例

// back_insert_iterator_reference.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;
   int i;

   vector<int> vec;
   for (i = 1 ; i < 4 ; ++i )
   {
      vec.push_back ( i );
   }

   vector <int>::iterator vIter;
   cout << "The vector vec is: ( ";
   for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++)
      cout << *vIter << " ";
   cout << ")." << endl;

   back_insert_iterator<vector<int> >::reference
        RefLast = *(vec.end ( ) - 1 );
   cout << "The last element in the vector vec is: "
        << RefLast << "." << endl;
}

The vector vec is: ( 1 2 3 ).
The last element in the vector vec is: 3.

另請參閱

<iterator>
C++ 標準程式庫中的執行緒安全
 C++ 標準程式庫參考

共用方式為