std::deque<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::deque

メンバ関数

deque::deque

deque::~deque

deque::operator=

deque::assign

deque::get_allocator

要素アクセス

deque::front

deque::back

イテレータ

deque::begindeque::cbegin (C++11)

deque::enddeque::cend (C++11)

deque::rbegindeque::crbegin (C++11)

deque::renddeque::crend (C++11)

容量

deque::empty

deque::size

deque::max_size

deque::shrink_to_fit

変更

deque::clear

deque::insert

deque::emplace

deque::erase

deque::push_front

deque::emplace_front

deque::pop_front

deque::push_back

deque::emplace_back

deque::pop_back

deque::resize

deque::swap

非メンバ関数

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)

 

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 <deque>#include <iostream>#include <iomanip>   int main(){std::deque<std::string> letters;   letters.push_back("abc");std::string s ="def"; letters.push_back(std::move(s));   std::cout<<"deque holds: ";for(auto&& i : letters)std::cout<<std::quoted(i)<<' ';std::cout<<"\nMoved-from string holds "<<std::quoted(s)<<'\n';}

出力:

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

関連項目

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