Namespaces
Variants

std::list<T,Allocator>:: splice

From cppreference.net
C++
Containers library
std::list
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
void splice ( const_iterator pos, list & other ) ;
(1) (constexpr seit C++26)
void splice ( const_iterator pos, list && other ) ;
(2) (seit C++11)
(constexpr seit C++26)
void splice ( const_iterator pos, list & other, const_iterator it ) ;
(3) (constexpr seit C++26)
void splice ( const_iterator pos, list && other, const_iterator it ) ;
(4) (seit C++11)
(constexpr seit C++26)
void splice ( const_iterator pos, list & other,
const_iterator first, const_iterator last ) ;
(5) (constexpr seit C++26)
void splice ( const_iterator pos, list && other,
const_iterator first, const_iterator last ) ;
(6) (seit C++11)
(constexpr seit C++26)

Überträgt Elemente von other nach * this . Die Elemente werden an Position pos eingefügt.

Wenn eine der folgenden Bedingungen erfüllt ist, ist das Verhalten undefiniert:

  • pos liegt nicht im Bereich [ begin ( ) , end ( ) ) .
  • get_allocator ( ) == other. get_allocator ( ) ist false .
1,2) Überträgt alle Elemente von other . other wird nach dem Vorgang leer.
Wenn * this und other auf dasselbe Objekt verweisen, ist das Verhalten undefiniert.
3,4) Überträgt das Element, auf das it zeigt.
* this und other können auf dasselbe Objekt verweisen. In diesem Fall gibt es keine Auswirkung, wenn pos == it oder pos == ++ it true ist.
Wenn it nicht im Bereich [ begin ( ) , end ( ) ) liegt, ist das Verhalten undefiniert.
5,6) Überträgt Elemente im Bereich [ first , last ) .
* this und other können auf dasselbe Objekt verweisen.
Wenn eine der folgenden Bedingungen erfüllt ist, ist das Verhalten undefiniert:
  • [ first , last ) ist kein gültiger Bereich in other ,
  • Ein Iterator in [ first , last ) ist nicht dereferenzierbar.
  • pos liegt in [ first , last ) .

Keine Iteratoren oder Referenzen werden ungültig. Wenn * this und other auf verschiedene Objekte verweisen, zeigen die Iteratoren zu den übertragenen Elementen nun in * this , nicht in other .

Inhaltsverzeichnis

Parameter

pos - Element, vor dem der Inhalt eingefügt wird
other - ein weiterer Container, aus dem der Inhalt übertragen wird
it - das Element, das von other nach * this übertragen wird
first, last - das Iteratorpaar, das den Bereich der Elemente definiert, die von other nach * this übertragen werden

Komplexität

1-4) Konstante.
5,6) Konstant, falls other auf dasselbe Objekt verweist wie * this , andernfalls linear in std:: distance ( first, last ) .

Beispiel

Diesen Code ausführen 
#include <iostream>
#include <list>
std::ostream& operator<<(std::ostream& ostr, const std::list<int>& list)
{
    for (auto& i : list)
        ostr << ' ' << i;
    return ostr;
}
int main ()
{
    std::list<int> list1{1, 2, 3, 4, 5};
    std::list<int> list2{10, 20, 30, 40, 50};
    auto it = list1.begin();
    std::advance(it, 2);
    list1.splice(it, list2);
    std::cout << "list1:" << list1 << '\n';
    std::cout << "list2:" << list2 << '\n';
    list2.splice(list2.begin(), list1, it, list1.end());
    std::cout << "list1:" << list1 << '\n';
    std::cout << "list2:" << list2 << '\n';
}

Ausgabe: 

list1: 1 2 10 20 30 40 50 3 4 5
list2:
list1: 1 2 10 20 30 40 50
list2: 3 4 5

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR Angewendet auf Verhalten wie veröffentlicht Korrektes Verhalten
LWG 250 C++98 Referenzen und Iteratoren auf das verschobene
Element(e) wurden alle ungültig gemacht 		sie verweisen oder zeigen auf das
gleiche Element(e) in * this
N2525 C++98 O(1)-Spleißen konnte nicht garantiert werden, wenn
get_allocator ( ) ! = other. get_allocator ( ) 		das Verhalten ist
in diesem Fall undefiniert

Siehe auch

führt zwei sortierte Listen zusammen
(öffentliche Elementfunktion)
entfernt Elemente nach bestimmten Kriterien
(öffentliche Elementfunktion)