std::list<T,Allocator>::push_back

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

コンテナライブラリ

array (C++11)

vector

deque

forward_list (C++11)

list

set

multiset

map

multimap

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

stack

queue

priority_queue

span (C++20)

 

std::list

メンバ関数

list::list

list::~list

list::operator=

list::assign

list::get_allocator

要素アクセス

list::front

list::back

イテレータ

list::beginlist::cbegin (C++11)

list::endlist::cend (C++11)

list::rbeginlist::crbegin (C++11)

list::rendlist::crend (C++11)

容量

list::empty

list::size

list::max_size

変更

list::clear

list::insert

list::emplace (C++11)

list::erase

list::push_front

list::emplace_front (C++11)

list::pop_front

list::push_back

list::emplace_back (C++11)

list::pop_back

list::resize

list::swap

操作

list::merge

list::splice

list::removelist::remove_if

list::reverse

list::unique

list::sort

非メンバ関数

std::swap

eraseerase_if (C++20)(C++20)

operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20)

推定ガイド(C++17)

 

<tbody> </tbody>

void push_back( const T& value );	(1)
void push_back( T&& value );	(2)	(C++11以上)

指定された要素 value をコンテナの終端に追加します。

1) 新しい要素は value のコピーとして初期化されます。

2) value が新しい要素にムーブされます。

どのイテレータも参照も無効化されません。

引数

value	-	追加する要素の値
型の要件
- オーバーロード (1) を使用するためには T は CopyInsertable の要件を満たさなければなりません。
- オーバーロード (2) を使用するためには T は MoveInsertable の要件を満たさなければなりません。

戻り値

(なし)

計算量

一定。

例外

例外が投げられた場合 (Allocator::allocate() または要素のコピー/ムーブのコンストラクタ/代入によって発生する可能性があります)、この関数は効果を持ちません (強い例外保証)。

例

Run this code

#include <list>
#include <iostream>
#include <iomanip>
 
int main()
{
    std::list<std::string> letters;
 
    letters.push_back("abc");
    std::string s = "def";
    letters.push_back(std::move(s));

    std::cout << "list holds: ";
    for (auto&& i : letters) std::cout << std::quoted(i) << ' ';
    std::cout << "\nMoved-from string holds " << std::quoted(s) << '\n';
}

出力:

list holds: "abc" "def" 
Moved-from string holds ""

関連項目

emplace_back (C++11)	要素を末尾にその場で構築します (パブリックメンバ関数)
push_front	要素を先頭に挿入します (パブリックメンバ関数)
pop_back	最後の要素を削除します (パブリックメンバ関数)