forward_list::insert_after

將項目新增至轉接清單的指定位置之後。

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
    );

參數

參數	說明
Where	目標轉接清單中第一個項目插入的位置。
Count	要插入的元素數目。
First	插入範圍的開頭。
Last	插入範圍的結束。
Val	加入至轉接清單的項目。
IList	要插入的 initializer_list。

傳回值

指定新插入的項目的迭代器 (只有第一個和最後的成員函式)。

備註

每成員函式插入至其餘運算元指定的序列中 (就在受控制序列中，Where 指向的項目之後)。

第一個成員函式插入具有 Val 值的項目，並傳回會指定新插入項目的迭代器。

第二個成員函式插入值 Val 的 Count 項目之複本。

如果 InputIterator 是整數型別，第三個成員函式行為與 insert(it, (size_type)First, (Type)Last)相同。 否則，它會插入序列 [First, Last)，此序列不能重疊最初的控制序列。

第四個成員函式插入由類別 initializer_list<Type> 物件指定的序列。

最後一個成員函式與第一個相同，但具有 rvalue 參考。

插入 N 項目會造成 N 建構函式的呼叫。 轉散發 發生，但沒有迭代器或參考變成無效。

如果例外狀況在一個或多個項目的插入時擲回，容器會保持不變，並重新擲回例外狀況。

需求

標題: <forward_list>

命名空間: std

請參閱

參考

forward_list 類別