std::forward_list<T,Allocator>:: emplace_front

template < class ... Args > void emplace_front ( Args && ... args ) ;		(C++11以降) (C++17まで)
template < class ... Args > reference emplace_front ( Args && ... args ) ;		(C++17以降) (constexpr C++26以降)

コンテナの先頭に新しい要素を挿入します。要素は std::allocator_traits::construct によって構築され、通常はプレースメント new を使用して、コンテナが提供する位置で要素をその場で構築します。引数 args... はコンストラクタに std:: forward < Args > ( args ) ... として転送されます。

イテレータや参照は無効化されません。

目次 1 パラメータ 2 戻り値 3 計算量 4 例外 5 関連項目

パラメータ

args	-	要素のコンストラクタに転送する引数
型要件
- T が EmplaceConstructible でなく、 args... から forward_list に構築できない場合、動作は未定義です。

戻り値

(なし)	(C++17まで)
挿入された要素への参照。	(C++17以降)

計算量

定数。

例外

何らかの理由で例外がスローされた場合、この関数は何も効果を持ちません（ strong exception safety guarantee ）。

関連項目

push_front

先頭に要素を挿入する (公開メンバ関数)