list::splice
Rimuove gli elementi dall'elenco di argomenti e li inserisce nell'elenco di destinazione.
void splice(
iterator _Where,
list<Type, Allocator>& _Right
);
void splice(
iterator _Where,
list<Type, Allocator>& _Right,
iterator _First
);
void splice(
iterator _Where,
list<Type, Allocator>& _Right,
iterator _First,
iterator _Last
);
Parametri
_Where
La posizione nell'elenco di destinazione prima della quale gli elementi dell'elenco di argomenti devono essere inseriti._Right
L'elenco di argomenti che deve essere inserito nell'elenco di destinazione._First
Il primo elemento nell'intervallo da inserire dall'elenco di argomenti._Last
Il primo elemento nell'intervallo da inserire dall'elenco di argomenti.
Note
La prima funzione membro inserisce tutti gli elementi nell'elenco di argomenti prima che l'elemento posizionato a _Where nell'elenco di destinazione.Elimina inoltre tutti gli elementi dall'elenco di argomenti.
La seconda funzione membro rimuove l'elemento fa riferimento da _First nell'elenco di argomenti e viene inserito prima dell'elemento nell'elenco di destinazione disponga puntato da _Where.
La terza funzione membro inserire l'intervallo definito da [_First, _Last) dall'elenco di argomenti prima dell'elemento nell'elenco di destinazione disponga puntato da _Where.Rimuove anche l'intervallo immesso dall'elenco di argomenti.
In tutti i casi, solo gli iteratori o riferimenti che puntano agli elementi sottoposti a splicing diventano non validi.
Esempio
// list_splice.cpp
// compile with: /EHsc
#include <list>
#include <iostream>
int main( )
{
using namespace std;
list <int> c1, c2, c3, c4;
list <int>::iterator c1_Iter, c2_Iter, w_Iter, f_Iter, l_Iter;
c1.push_back( 10 );
c1.push_back( 11 );
c2.push_back( 12 );
c2.push_back( 20 );
c2.push_back( 21 );
c3.push_back( 30 );
c3.push_back( 31 );
c4.push_back( 40 );
c4.push_back( 41 );
c4.push_back( 42 );
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;
w_Iter = c2.begin( );
w_Iter++;
c2.splice( w_Iter,c1 );
cout << "After splicing c1 into c2: c2 =";
for ( c2_Iter = c2.begin( ); c2_Iter != c2.end( ); c2_Iter++ )
cout << " " << *c2_Iter;
cout << endl;
f_Iter = c3.begin( );
c2.splice( w_Iter,c3, f_Iter );
cout << "After splicing the first element of c3 into c2: c2 =";
for ( c2_Iter = c2.begin( ); c2_Iter != c2.end( ); c2_Iter++ )
cout << " " << *c2_Iter;
cout << endl;
f_Iter = c4.begin( );
l_Iter = c4.end( );
l_Iter--;
c2.splice( w_Iter,c4, f_Iter, l_Iter );
cout << "After splicing a range of c4 into c2: c2 =";
for ( c2_Iter = c2.begin( ); c2_Iter != c2.end( ); c2_Iter++ )
cout << " " << *c2_Iter;
cout << endl;
}
Requisiti
intestazione: <list>
Spazio dei nomi: deviazione standard