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

メンバ関数

vector::vector

vector::~vector

vector::operator=

vector::assign

vector::get_allocator

要素アクセス

vector::at

vector::operator[]

vector::front

vector::back

vector::data (C++11)

イテレータ

vector::beginvector::cbegin (C++11)

vector::endvector::cend (C++11)

vector::rbeginvector::crbegin (C++11)

vector::rendvector::crend (C++11)

容量

vector::empty

vector::size

vector::max_size

vector::reserve

vector::capacity

vector::shrink_to_fit (C++11)

変更

vector::clear

vector::insert

vector::emplace (C++11)

vector::erase

vector::push_back

vector::emplace_back (C++11)

vector::pop_back

vector::resize

vector::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)

 

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

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

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

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

新しい size() が capacity() より大きい場合は、すべてのイテレータおよび参照 (終端イテレータも含む) が無効化されます。 そうでなければ、終端イテレータのみが無効化されます。

引数

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

戻り値

(なし)

計算量

償却定数時間。

例外

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

T のムーブコンストラクタが noexcept でなく、 T が *this に CopyInsertable でない場合、 vector は例外を投げるムーブコンストラクタを使用します。 それが例外を投げた場合、保証は断念され、その効果は未規定です。

(C++11以上)

ノート

処理系によっては、 push_back によって再確保が発生し、暗黙に reserve(size()+1) と同等の処理を呼んだことによって max_size を超過した場合、 std::length_error を投げる場合もあります。

例

Run this code

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

出力:

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

関連項目

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