Namespaces
Variants

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

From cppreference.net
static constexpr void reserve ( size_type new_cap ) ;
(C++26以降)

何も行いませんが、 std::bad_alloc をスローする可能性があります。容量(内部ストレージサイズ)を増やす要求は、 std:: inplace_vector < T, N > が固定容量コンテナであるため無視されます。

目次

パラメータ

new_cap - inplace_vector の新しい容量(要素数)

戻り値

(なし)

計算量

定数。

例外

std::bad_alloc new_cap > capacity() true の場合。

注記

この関数はベクトルライクなインターフェースとの互換性のために存在します。

#include <cassert>
#include <inplace_vector>
#include <iostream>
int main()
{
    std::inplace_vector<int, 4> v{1, 2, 3};
    assert(v.capacity() == 4 && v.size() == 3);
    v.reserve(2); // 何も行わない
    assert(v.capacity() == 4 && v.size() == 3);
    try
    {
        v.reserve(13); // 例外をスロー(要求容量 > N のため);v は変更されない
    }
    catch(const std::bad_alloc& ex)
    {
        std::cout << ex.what() << '\n';
    }
    assert(v.capacity() == 4 && v.size() == 3);
}

出力例:

std::bad_alloc

関連項目

要素数を返す
(公開メンバ関数)
[static]
格納可能な最大要素数を返す
(公開静的メンバ関数)
格納されている要素数を変更する
(公開メンバ関数)
[static]
現在確保されているストレージに格納可能な要素数を返す
(公開静的メンバ関数)
未使用メモリを解放してメモリ使用量を削減する
(公開静的メンバ関数)