insert_iterator 클래스

아티클
08/02/2024

출력 반복기의 요구 사항을 충족하는 반복기 어댑터에 대해 설명합니다. 요소를 덮어쓰지 않고 시퀀스에 삽입합니다. 따라서 C++ 시퀀스 및 결합 컨테이너의 반복기에서 제공하는 덮어쓰기 의미 체계와 다른 의미 체계를 제공합니다. insert_iterator 클래스는 조정하는 컨테이너 형식에 대해 템플릿화됩니다.

구문

template <class Container>
class insert_iterator;

매개 변수

컨테이너
insert_iterator가 요소를 삽입할 컨테이너의 형식입니다.

설명

형식 Container 의 컨테이너는 변수 크기의 컨테이너에 대한 요구 사항을 충족해야 하며 매개 변수가 형식이고 형식 Container::iterator Container::value_type Container::iterator을 반환하는 2 인수 삽입 멤버 함수가 있어야 합니다. C++ 표준 라이브러리 시퀀스 및 정렬된 연관 컨테이너는 이러한 요구 사항을 준수하며 insert_iterator를 사용할 수 있도록 조정되었습니다. 연관 컨테이너의 경우 위치 인수는 힌트로 처리되며, 힌트가 얼마나 양호한가에 따라 성능이 향상되거나 저하될 수 있습니다. insert_iterator는 항상 컨테이너를 사용하여 초기화해야 합니다.

생성자

생성자	Description
insert_iterator	컨테이너의 지정된 위치에 요소를 삽입하는 `insert_iterator`를 만듭니다.

Typedef

형식 이름	설명
container_type	일반 삽입 대상인 컨테이너를 나타내는 형식입니다.
reference	연관 컨테이너에서 제어하는 시퀀스의 요소에 대한 참조를 제공하는 형식입니다.

연산자

연산자	설명
operator*	일반 삽입을 위해 출력 반복기 식 * `i` = `x`를 구현하는 데 사용된 역참조 연산자입니다.
operator++	값을 저장할 다음 위치에 `insert_iterator`를 증가시킵니다.
operator=	일반 삽입을 위해 출력 반복기 식 * `i` = `x`를 구현하는 데 사용된 대입 연산자입니다.

요구 사항

헤더: <반복기>

네임스페이스: std

insert_iterator::container_type

일반 삽입 대상인 컨테이너를 나타내는 형식입니다.

typedef Container container_type;

설명

이 형식은 템플릿 매개 변수 Container의 동의어입니다.

예시

// insert_iterator_container_type.cpp
// compile with: /EHsc
#include <iterator>
#include <list>
#include <iostream>

int main( )
{
   using namespace std;

   list<int> L1;
   insert_iterator<list<int> >::container_type L2 = L1;
   inserter ( L2, L2.end ( ) ) = 20;
   inserter ( L2, L2.end ( ) ) = 10;
   inserter ( L2, L2.begin ( ) ) = 40;

   list <int>::iterator vIter;
   cout << "The list L2 is: ( ";
   for ( vIter = L2.begin ( ) ; vIter != L2.end ( ); vIter++ )
      cout << *vIter << " ";
   cout << ")." << endl;
}
/* Output:
The list L2 is: ( 40 20 10 ).
*/

insert_iterator::insert_iterator

컨테이너의 지정된 위치에 요소를 삽입하는 insert_iterator를 만듭니다.

insert_iterator(Container& _Cont, typename Container::iterator _It);

매개 변수

_계속
insert_iterator에서 요소를 삽입할 대상 컨테이너입니다.

_술래
삽입할 위치입니다.

설명

모든 컨테이너에는 insert_iterator에서 호출하는 삽입 멤버 함수가 있습니다. 연관 컨테이너의 경우 위치 매개 변수는 단순히 제안입니다. inserter 함수는 값에 삽입하는 편리한 방법을 제공합니다.

예시

// insert_iterator_insert_iterator.cpp
// compile with: /EHsc
#include <iterator>
#include <list>
#include <iostream>

int main( )
{
   using namespace std;
   int i;
   list <int>::iterator L_Iter;

   list<int> L;
   for (i = 1 ; i < 4 ; ++i )
   {
      L.push_back ( 10 * i );
   }

   cout << "The list L is:\n ( ";
   for ( L_Iter = L.begin( ) ; L_Iter != L.end( ); L_Iter++)
      cout << *L_Iter << " ";
   cout << ")." << endl;

   // Using the member function to insert an element
   inserter ( L, L.begin ( ) ) = 2;

   // Alternatively, you may use the template version
   insert_iterator< list < int> > Iter(L, L.end ( ) );
*Iter = 300;

   cout << "After the insertions, the list L is:\n ( ";
   for ( L_Iter = L.begin( ) ; L_Iter != L.end( ); L_Iter++ )
      cout << *L_Iter << " ";
   cout << ")." << endl;
}
/* Output:
The list L is:
( 10 20 30 ).
After the insertions, the list L is:
( 2 10 20 30 300 ).
*/

insert_iterator::operator*

주소가 지정된 요소를 반환하는 삽입 반복기를 역참조합니다.

insert_iterator<Container>& operator*();

Return Value

멤버 함수는 주소가 지정된 요소의 값을 반환합니다.

설명

출력 반복기 식 *Iter = 값을 구현하는 데 사용됩니다. 시퀀스의 요소를 처리하는 반복기인 경우 Iter *Iter = 값은 해당 요소를 값으로 바꾸고 시퀀스의 총 요소 수를 변경하지 않습니다.

예시

// insert_iterator_op_deref.cpp
// compile with: /EHsc
#include <iterator>
#include <list>
#include <iostream>

int main( )
{
   using namespace std;
   int i;
   list <int>::iterator L_Iter;

   list<int> L;
   for (i = 0 ; i < 4 ; ++i )
   {
      L.push_back ( 2 * i );
   }

   cout << "The original list L is:\n ( ";
   for ( L_Iter = L.begin( ) ; L_Iter != L.end( ); L_Iter++ )
      cout << *L_Iter << " ";
   cout << ")." << endl;

   insert_iterator< list < int> > Iter(L, L.begin ( ) );
*Iter = 10;
*Iter = 20;
*Iter = 30;

   cout << "After the insertions, the list L is:\n ( ";
   for ( L_Iter = L.begin( ) ; L_Iter != L.end( ); L_Iter++ )
      cout << *L_Iter << " ";
   cout << ")." << endl;
}
/* Output:
The original list L is:
( 0 2 4 6 ).
After the insertions, the list L is:
( 10 20 30 0 2 4 6 ).
*/

insert_iterator::operator++

값을 저장할 다음 위치에 insert_iterator를 증가시킵니다.

insert_iterator<Container>& operator++();

insert_iterator<Container> operator++(int);

매개 변수

값을 저장할 수 있는 다음 위치의 주소를 지정하는 insert_iterator입니다.

설명

preincrementation과 postincrementation 연산자는 둘 다 동일한 결과를 반환합니다.

예시

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

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

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

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

   insert_iterator<vector<int> > ii ( vec, vec.begin ( ) );
*ii = 30;
   ii++;
*ii = 40;
   ii++;
*ii = 50;

   cout << "After the insertions, the vector vec becomes:\n ( ";
   for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++ )
      cout << *vIter << " ";
   cout << ")." << endl;
}
/* Output:
The vector vec is:
( 1 2 3 4 ).
After the insertions, the vector vec becomes:
( 30 40 50 1 2 3 4 ).
*/

insert_iterator::operator=

컨테이너에 값을 삽입하고 새 요소를 가리키도록 업데이트된 반복기를 반환합니다.

insert_iterator<Container>& operator=(
    typename Container::const_reference val,);

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

매개 변수

val
컨테이너에 할당할 값입니다.

Return Value

컨테이너에 삽입된 요소에 대한 참조입니다.

설명

첫 번째 멤버 연산자는 다음을 계산합니다.

Iter = container->insert(Iter, val);

++Iter;

그런 다음 *this를 반환합니다.

두 번째 멤버 연산자는 다음을 계산합니다.

Iter = container->insert(Iter, std::move(val));

++Iter;

그런 다음 *this를 반환합니다.

예시

// insert_iterator_op_assign.cpp
// compile with: /EHsc
#include <iterator>
#include <list>
#include <iostream>

int main( )
{
   using namespace std;
   int i;
   list <int>::iterator L_Iter;

   list<int> L;
   for (i = 0 ; i < 4 ; ++i )
   {
      L.push_back ( 2 * i );
   }

   cout << "The original list L is:\n ( ";
   for ( L_Iter = L.begin( ) ; L_Iter != L.end( ); L_Iter++ )
      cout << *L_Iter << " ";
   cout << ")." << endl;

   insert_iterator< list < int> > Iter(L, L.begin ( ) );
*Iter = 10;
*Iter = 20;
*Iter = 30;

   cout << "After the insertions, the list L is:\n ( ";
   for ( L_Iter = L.begin( ) ; L_Iter != L.end( ); L_Iter++ )
      cout << *L_Iter << " ";
   cout << ")." << endl;
}
/* Output:
The original list L is:
( 0 2 4 6 ).
After the insertions, the list L is:
( 10 20 30 0 2 4 6 ).
*/

insert_iterator::reference

연관 컨테이너에서 제어하는 시퀀스의 요소에 대한 참조를 제공하는 형식입니다.

typedef typename Container::reference reference;

설명

이 형식은 연관 컨테이너에서 제어하는 시퀀스의 요소에 대한 참조를 제공합니다.

예시

// insert_iterator_container_reference.cpp
// compile with: /EHsc
#include <iterator>
#include <list>
#include <iostream>

int main( )
{
   using namespace std;

   list<int> L;
   insert_iterator<list<int> > iivIter( L , L.begin ( ) );
*iivIter = 10;
*iivIter = 20;
*iivIter = 30;

   list<int>::iterator LIter;
   cout << "The list L is: ( ";
   for ( LIter = L.begin ( ) ; LIter != L.end ( ); LIter++ )
      cout << *LIter << " ";
   cout << ")." << endl;

   insert_iterator<list<int> >::reference
        RefFirst = *(L.begin ( ));
   cout << "The first element in the list L is: "
        << RefFirst << "." << endl;
}
/* Output:
The list L is: ( 10 20 30 ).
The first element in the list L is: 10.
*/

참고 항목

<iterator>
C++ 표준 라이브러리의 스레드 보안
C++ 표준 라이브러리 참조

다음을 통해 공유

insert_iterator 클래스

구문

매개 변수

설명

생성자

Typedef

연산자

요구 사항

insert_iterator::container_type

설명

예시

insert_iterator::insert_iterator

매개 변수

설명

예시

insert_iterator::operator*

Return Value

설명

예시

insert_iterator::operator++

매개 변수

설명

예시

insert_iterator::operator=

매개 변수

Return Value

설명

예시

insert_iterator::reference

설명

예시

참고 항목

피드백

추가 리소스