list::list

Article
03/26/2013

Construit une liste d'une taille particulière ou avec des éléments d'une valeur spécifique ou à un allocateur spécifique ou en tant que copie de l'ensemble ou une partie d'une liste.

list( );
explicit list(
   const Allocator& _Al
);
explicit list(
   size_type _Count
);
list(
   size_type _Count,
   const Type& _Val
);
list(
   size_type _Count,
   const Type& _Val,
   const Allocator& _Al
);
list(
   const list& _Right
);
template<class InputIterator>
   list(
      InputIterator _First,
      InputIterator _Last
   );
template<class InputIterator >
   list(
      InputIterator _First,
      InputIterator _Last,
      const Allocator& _Al
   );
list(
   list&& _Right
);

Paramètres

Paramètre	Description
_Al	Classe d'allocateur à utiliser avec cet objet.
_Count	Le nombre d'éléments dans la liste développée.
_Val	La valeur des éléments de la liste développée.
_Right	La liste de la liste générée doit être une copie.
_First	Position du premier élément de la plage d'éléments à copier.
_Last	Position du premier élément au delà de la plage d'éléments à copier.

Notes

Tous les constructeurs enregistre un objet d'allocation (_Al) et initialisent la liste.

get_allocator retourne une copie de l'objet d'allocation utilisé pour construire une liste.

Les deux premiers constructeurs spécifient une liste initiale vide, la deuxième spécifiant le type de l'allocateur (_Al) à utiliser.

Le troisième constructeur spécifie une répétition d'un nombre spécifié (_Count) d'éléments de la valeur par défaut pour la classe Type.

Le quatrième et les cinquièmes constructeurs spécifient une répétition des éléments (_Count) de valeur _Val.

La sixième constructeur spécifie une copie de la liste _Right.

Les deux suivants constructeurs copiez la plage [_First, _Last) d'une liste.

Le dernier constructeur déplace la liste _Right.

Aucun des constructeurs n'exécute aucune réallocation intermédiaire.

Exemple

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

int main( ) 
{
   using namespace std;
   list <int>::iterator c1_Iter, c2_Iter, c3_Iter, c4_Iter, c5_Iter, c6_Iter, c7_Iter;

   // Create an empty list c0
   list <int> c0;

   // Create a list c1 with 3 elements of default value 0
   list <int> c1( 3 );

   // Create a list c2 with 5 elements of value 2
   list <int> c2( 5, 2 );

   // Create a list c3 with 3 elements of value 1 and with the 
   // allocator of list c2
   list <int> c3( 3, 1, c2.get_allocator( ) );

   // Create a copy, list c4, of list c2
   list <int> c4(c2);

   // Create a list c5 by copying the range c4[_First, _Last)
   c4_Iter = c4.begin( );
   c4_Iter++;
   c4_Iter++;
   list <int> c5( c4.begin( ), c4_Iter );

   // Create a list c6 by copying the range c4[_First, _Last) and with 
   // the allocator of list c2
   c4_Iter = c4.begin( );
   c4_Iter++;
   c4_Iter++;
   c4_Iter++;
   list <int> c6( c4.begin( ), c4_Iter, c2.get_allocator( ) );

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

   cout << "c3 =";
   for ( c3_Iter = c3.begin( ); c3_Iter != c3.end( ); c3_Iter++ )
      cout << " " << *c3_Iter;
   cout << endl;

   cout << "c4 =";
   for ( c4_Iter = c4.begin( ); c4_Iter != c4.end( ); c4_Iter++ )
      cout << " " << *c4_Iter;
   cout << endl;

   cout << "c5 =";
   for ( c5_Iter = c5.begin( ); c5_Iter != c5.end( ); c5_Iter++ )
      cout << " " << *c5_Iter;
   cout << endl;

   cout << "c6 =";
   for ( c6_Iter = c6.begin( ); c6_Iter != c6.end( ); c6_Iter++ )
      cout << " " << *c6_Iter;
   cout << endl;

   // Move list c6 to list c7
   list <int> c7( move(c6) );
   list <int>::iterator c7_Iter,
   
   cout << "c7 =" ;
   for ( c7_Iter = c7.begin( ) ; c7_Iter != c7.end( ) ; c7_Iter++ )
      cout << " " << *c7_Iter;
   cout << endl;
}