list::insert

요소 또는 요소 수가 요소 범위 목록에 지정 된 위치에 삽입합니다.

iterator insert(
   const_iterator _Where,
   const Type& _Val
);
iterator insert(
   const_iterator _Where,
   Type&& _Val
);
void insert(
   iterator _Where,
   size_type _Count,
   const Type& _Val
);
template<class InputIterator>
   void insert(
      iterator _Where,
      InputIterator _First,
      InputIterator _Last
   );

매개 변수

Parameter	설명
_Where	대상 목록에서 첫 번째 요소가 삽입 된 위치입니다.
_Val	목록에 삽입할 요소의 값입니다.
_Count	목록에 삽입 되는 요소의 수입니다.
_First	인수 목록에서 복사할 요소의 범위에 있는 첫 번째 요소의 위치입니다.
_Last	복사할 인수 목록의 첫 번째 요소는 요소 범위를 벗어나는 위치입니다.

반환 값

처음 두 삽입 함수는 새 요소 목록에 삽입 된 위치를 가리키는 반복기를 반환 합니다.

예제

// list_class_insert.cpp
// compile with: /EHsc
#include <list>
#include <iostream>
#include <string>

int main( ) 
{
   using namespace std;
   list <int> c1, c2;
   list <int>::iterator Iter;
   
   c1.push_back( 10 );
   c1.push_back( 20 );
   c1.push_back( 30 );
   c2.push_back( 40 );
   c2.push_back( 50 );
   c2.push_back( 60 );

   cout << "c1 =";
   for ( Iter = c1.begin( ); Iter != c1.end( ); Iter++ )
      cout << " " << *Iter;
   cout << endl;

   Iter = c1.begin( );
   Iter++;
   c1.insert( Iter, 100 );
   cout << "c1 =";
   for ( Iter = c1.begin( ); Iter != c1.end( ); Iter++ )
      cout << " " << *Iter;
   cout << endl;

   Iter = c1.begin( );
   Iter++;
   Iter++;
   c1.insert( Iter, 2, 200 );

   cout << "c1 =";
   for ( Iter = c1.begin( ); Iter != c1.end( ); Iter++ )
      cout << " " << *Iter;
   cout << endl;

   c1.insert( ++c1.begin( ), c2.begin( ),--c2.end( ) );

   cout << "c1 =";
   for ( Iter = c1.begin( ); Iter != c1.end( ); Iter++ )
      cout << " " << *Iter;
   cout << endl;

// initialize a list of strings by moving
   list < string > c2;
   string str("a");

   c2.insert( c2.begin(), move( str ) );
   cout << "Moved first element: " << c2.front( ) << endl;
}

Output

c1 = 10 20 30
c1 = 10 100 20 30
c1 = 10 100 200 200 20 30
c1 = 10 40 50 100 200 200 20 30
Moved first element: a

요구 사항

헤더: <list>

네임 스페이스: std

참고 항목

참조

list Class

list::insert (STL Samples)

표준 템플릿 라이브러리