deque::insert

Article
03/26/2013

Insère un élément ou un nombre d'éléments ou une plage d'éléments dans le deque à une position spécifiée.

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

Paramètres

Paramètre	Description
_Where	Position dans le deque cible où le premier élément est inséré.
_Val	La valeur de l'élément qui est inséré dans le deque.
_Count	Le nombre d'éléments sont insérés dans le deque.
_First	Position du premier élément de la plage des éléments du deque d'argument à copier.
_Last	Position du premier élément au delà de la plage d'éléments dans le deque d'argument à copier.

Valeur de retour

Les deux premières fonctions de insérer retournent un itérateur qui indique la position où le nouvel élément a été inséré dans le deque.

Notes

Toute opération d'insertion peut s'avérer coûteuse.

Code

// deque_insert.cpp
// compile with: /EHsc
#include <deque>
#include <iostream>
#include <string>

int main( ) 
{
   using namespace std;
   deque <int> c1, c2;
   deque <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 deque of strings by moving
   deque < string > c3;
   string str("a");

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

Sortie

[ 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

Configuration requise

en-tête : <deque>

l'espace de noms : DST

Voir aussi

Référence

deque Class

deque::insert (STL Samples)

Modèles Standard

Partager via