std::list<T,Allocator>::push_back
ja.cppreference.net より
void push_back( const T& value );
|
(1) | |
void push_back( T&& value );
|
(2) | (C++11より) |
指定された要素 value をコンテナの末尾に追加します。
1) 新しい要素は
value のコピーとして初期化されます。2)
value は新しい要素にムーブされます。イテレータや参照は無効化されません。
パラメータ
| value | - | 追加する要素の値 |
|
(C++11以降) | ||||||
戻り値
(なし)
計算量
定数。
例外
例外がスローされた場合(
Allocator::allocate()
または要素のコピー/ムーブコンストラクタ/代入による可能性あり)、この関数は何も効果を持ちません(
strong exception guarantee
)。
例
このコードを実行
#include <iomanip> #include <iostream> #include <string> #include <list> int main() { std::list<std::string> letters; letters.push_back("abc"); std::string s{"def"}; letters.push_back(std::move(s)); std::cout << "std::list letters holds: "; for (auto&& e : letters) std::cout << std::quoted(e) << ' '; std::cout << "\nMoved-from string s holds: " << std::quoted(s) << '\n'; }
出力例:
std::list letters holds: "abc" "def" Moved-from string s holds: ""
関連項目
|
(C++11)
|
要素をその場で末尾に構築する
(公開メンバ関数) |
|
要素を先頭に挿入する
(公開メンバ関数) |
|
|
末尾の要素を削除する
(公開メンバ関数) |
|
|
引数から推論された型の
std::back_insert_iterator
を作成する
(関数テンプレート) |