Namespaces
Variants

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 - 追加する要素の値

型要件
-
以下の条件が満たされる場合、動作は未定義です:
1) T が CopyInsertable を list に満たさない場合。
2) T が MoveInsertable を list に満たさない場合。
(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: ""

関連項目

要素をその場で末尾に構築する
(公開メンバ関数)
要素を先頭に挿入する
(公開メンバ関数)
末尾の要素を削除する
(公開メンバ関数)
引数から推論された型の std::back_insert_iterator を作成する
(関数テンプレート)