std::deque<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 ) ... として転送されます。

すべてのイテレータ（ end() イテレータを含む）は無効化されます。参照は無効化されません。

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

パラメータ

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

戻り値

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

計算量

定数。

例外

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

関連項目

push_front

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