名前空間
変種

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

    提供: cppreference.com

    [edit template]
     
    C++
     
    コンテナライブラリ
     
    std::list
    メンバ関数
    要素アクセス
    イテレータ
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    容量
    変更
    (C++11)
    (C++11)
    (C++11)
    操作
    非メンバ関数
    (C++20)(C++20)
    (C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20)
    推定ガイド(C++17)
     
    <tbody> </tbody>
    template< class... Args > iterator emplace( const_iterator pos, Args&&... args );
    		 (C++11以上)

    新しい要素を pos の前に直接挿入します。 要素は std::allocator_traits::construct を通して構築されます。 これは一般的にはコンテナによって提供される位置に要素をその場で構築するために placement new を使用します。 引数 args... はコンストラクタに std::forward<Args>(args)... として転送されます。

    どのイテレータも参照も無効化されません。

    引数

    pos - 前に新しい要素が構築されるイテレータ
    args - 要素のコンストラクタに転送される引数
    型の要件
    -
    T (コンテナの要素型) は EmplaceConstructible の要件を満たさなければなりません。

    戻り値

    挿入された要素を指すイテレータ。

    計算量

    一定。

    例外

    例外が (例えばコンストラクタによって) 投げられた場合、この関数がまったく呼ばれなかったかのように、コンテナは変更されません (強い例外保証)。


    関連項目

    		 要素を挿入します
    (パブリックメンバ関数) [edit]