forward_list::insert_after
Fügt der Vorwärtsliste nach einer angegebenen Position Elemente hinzu.
iterator insert_after(
const_iterator Where,
const Type& Val);
void insert_after(
const_iterator Where,
size_type Count,
const Type& Val);
void insert_after(
const iterator Where,
initializer_list<Type> IList
);
iterator insert_after(
const_iterator Where,
Type&& Val
);
template<class InputIterator>
void insert_after(
const_iterator Where,
InputIterator First,
InputIterator Last
);
Parameter
Parameter |
Beschreibung |
|---|---|
Where |
Die Position in der Zielvorwärtsliste, an der das erste Element eingefügt wird. |
Count |
Die Anzahl einzufügender Elemente. |
First |
Der Anfang des Einfügebereichs. |
Last |
Das Ende des Einfügebereichs. |
Val |
Das Element hinzugefügt Vorwärtsliste. |
IList |
Das einzufügende initializer_list-Element. |
Rückgabewert
Ein Iterator, der das neu eingefügte Element festlegt (nur erste und letzte Memberfunktionen).
Hinweise
Jede der Memberfunktionseinfügungen – direkt nach dem Element, auf das von Where in der gesteuerten Sequenz gezeigt wird – eine Sequenz, die von den verbleibenden Operanden angegeben wird.
Die erste Memberfunktion fügt ein Element ein, das den Wert Val aufweist und ein Iterator zurückgibt, der das neu eingefügte Element festlegt.
Die zweite Memberfunktion fügt eine Wiederholung der Count-Elemente des Werts Val ein.
Wenn InputIterator ein Ganzzahltyp ist, verhält sich die dritte Memberfunktion genau wie insert(it, (size_type)First, (Type)Last). Andernfalls wird die Sequenz [First, Last) eingefügt, die die ursprüngliche gesteuerte Sequenz nicht überschneiden darf.
Die vierte Memberfunktion fügt die Sequenz ein, die vom Objekt der Klasse initializer_list<Type> angegeben wird.
Die letzte Memberfunktion gleicht der ersten, aber mit einem rvalue-Verweis.
Das Einfügen von N-Elementen verursacht N-Konstruktoraufrufe. Neuzuordnung erfolgt, aber es werden keine Iteratoren oder Verweise ungültig.
Wird während der Einfügung bei einem oder mehreren Elementen eine Ausnahme ausgelöst wird, wird der Container unverändert belassen, und die Ausnahme wird erneut ausgelöst.
Anforderungen
Header: <forward_list>
Namespace: std