Namespaces
Variants

std::inplace_vector<T,N>:: unchecked_push_back

From cppreference.net
C++
Containers library
std::inplace_vector
Member types
Member functions
Non-member functions
constexpr reference unchecked_push_back ( const T & value ) ;
(1) (C++26以降)
constexpr reference unchecked_push_back ( T && value ) ;
(2) (C++26以降)

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

次と同等： return * try_push_back ( std:: forward < decltype ( value ) > ( value ) ) ;

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

これらの関数を呼び出す前に、 size ( ) < capacity ( ) が true でなければなりません。そうでない場合、動作は未定義です。

イテレータおよび参照は無効化されません。ただし、挿入が発生した場合、 end() は無効化されます。

目次

翻訳のポイント： - 「Contents」を「目次」に翻訳 - C++関連の専門用語（Parameters, Return value, Complexity, Exceptions, Notes, Example, See also）は原文のまま保持 - HTMLタグ、属性、クラス名、IDは一切変更せず - 数値、リンク先、構造は完全に保持 - プロフェッショナルな技術文書としての正確性を維持

パラメータ

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

戻り値

back() 、すなわち挿入された要素への参照。

計算量

定数。

例外

挿入された要素の初期化によってスローされるあらゆる例外。

何らかの理由で例外がスローされた場合、これらの関数は何も効果を持ちません（ strong exception safety guarantee ）。

注記

このセクションは不完全です
理由: このAPIの目的を説明してください。

例

このコードを実行 
#include <cassert>
#include <inplace_vector>
#include <string>
int main()
{
    std::inplace_vector<std::string, 2> fauna;
    std::string dog{"dog"};
    auto& r1 = fauna.unchecked_push_back("cat"); // オーバーロード (1)
    assert(r1 == "cat" and fauna.size() == 1);
    auto& r2 = fauna.unchecked_push_back(std::move(dog)); // オーバーロード (2)
    assert(r2 == "dog" and fauna.size() == 2);
    assert(fauna[0] == "cat" and fauna[1] == "dog");
    // fauna.unchecked_push_back("bug"); // 未定義動作: 空き領域がありません
}

関連項目

末尾に要素を追加する
(公開メンバ関数)
末尾に要素をその場で構築する
(公開メンバ関数)
末尾に要素の範囲を追加する
(公開メンバ関数)
末尾に要素を追加しようと試みる
(公開メンバ関数)
末尾に要素をその場で構築しようと試みる
(公開メンバ関数)
末尾に要素の範囲を追加しようと試みる
(公開メンバ関数)
無条件に末尾に要素をその場で構築する
(公開メンバ関数)
最後の要素を削除する
(公開メンバ関数)
引数から推論された型の std::back_insert_iterator を作成する
(関数テンプレート)