list::splice

Článek
06/09/2015

Odebere elementy ze zdrojového seznamu a vloží je do cílového seznamu.

// insert the entire source list void splice( const_iterator Where, list<Type, Allocator>& Source ); void splice( const_iterator Where, list<Type, Allocator>&& Source );  // insert one element of the source list void splice( const_iterator Where, list<Type, Allocator>& Source, const_iterator Iter ); void splice( const_iterator Where, list<Type, Allocator>&& Source, const_iterator Iter );  // insert a range of elements from the source list void splice( const_iterator Where, list<Type, Allocator>& Source, const_iterator First, const_iterator Last );  void splice( const_iterator Where, list<Type, Allocator>&& Source, const_iterator First, const_iterator Last );

Parametry

Where
Pozice v seznamu cíl před který chcete vložit.
Source
Seznam zdrojů, který má být vložen do seznamu cíl.
Iter
Element, který má být vložen ze zdrojového seznamu.
First
Prvním elementem v rozsahu, který má být vložen ze zdrojového seznamu.
Last
První pozice za posledním elementem v rozsahu, který má být vložen ze zdrojového seznamu.

Poznámky

První pár členské funkce vloží všechny elementy ve zdrojovém seznamu do seznamu cíl před pozici, na který odkazuje Where a odebere všechny prvky ze zdrojového seznamu.(&Sourcenesmí být roven this.)

Druhý pár členské funkce vloží prvek, na který odkazuje Iter před pozici v seznamu cíl odkazuje Where a odebere Iter ze zdrojového seznamu.(Pokud Where == Iter || Where == ++Iter, nedošlo k žádné změně.)

Třetí dvojice členské funkce vloží určený rozsah [First, Last) dříve, než element v seznamu cíl odkazuje Where a odebere se sítěmi elementy ze zdrojového seznamu.(Pokud &Source == this, rozsah [First, Last) nesmí obsahovat element, na kterou odkazuje Where.)

Pokud ranged uživatele programu splice vloží N prvky, a &Source != this, aktualizaci objektu třídy iterační se zvýší, N časy.

Ve všech případech iterátory, ukazatele nebo odkazy, které odkazují na spliced elementy nadále platné a jsou převedeny do cílového kontejneru.

Příklad

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

using namespace std;

template <typename S> void print(const S& s) {
    cout << s.size() << " elements: ";

    for (const auto& p : s) {
        cout << "(" << p << ") ";
    }

    cout << endl;
}

int main()
{
    list<int> c1{10,11};
    list<int> c2{20,21,22};
    list<int> c3{30,31};
    list<int> c4{40,41,42,43};

    list<int>::iterator where_iter;
    list<int>::iterator first_iter;
    list<int>::iterator last_iter;

    cout << "Beginning state of lists:" << endl;
    cout << "c1 = ";
    print(c1);
    cout << "c2 = ";
    print(c2);
    cout << "c3 = ";
    print(c3);
    cout << "c4 = ";
    print(c4);

    where_iter = c2.begin();
    ++where_iter; // start at second element
    c2.splice(where_iter, c1);
    cout << "After splicing c1 into c2:" << endl;
    cout << "c1 = ";
    print(c1);
    cout << "c2 = ";
    print(c2);

    first_iter = c3.begin();
    c2.splice(where_iter, c3, first_iter);
    cout << "After splicing the first element of c3 into c2:" << endl;
    cout << "c3 = ";
    print(c3);
    cout << "c2 = ";
    print(c2);

    first_iter = c4.begin();
    last_iter = c4.end();
    // set up to get the middle elements
    ++first_iter;
    --last_iter;
    c2.splice(where_iter, c4, first_iter, last_iter);
    cout << "After splicing a range of c4 into c2:" << endl;
    cout << "c4 = ";
    print(c4);
    cout << "c2 = ";
    print(c2);
}

Požadavky

Záhlaví: < seznamu >

Obor názvů: std

Viz také

Referenční dokumentace

list – třída

Standardní knihovna šablon

Sdílet prostřednictvím