名前空間
変種
操作

std::list::emplace

提供: cppreference.com
< cpp‎ | container‎ | list
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]