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

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.

Примечания

Эта функция существует для совместимости с интерфейсами, подобными интерфейсу vector.

Пример

#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); // does nothing
    assert(v.capacity() == 4 && v.size() == 3);

    try
    {
        v.reserve(13); // throws, because requested capacity > N; v is left unchanged
    }
    catch(const std::bad_alloc& ex)
    {
        std::cout << ex.what() << '\n';
    }
    assert(v.capacity() == 4 && v.size() == 3);
}

Возможный вывод:

std::bad_alloc

См. также

size	возвращает количество элементов (открытая функция-член)
max_size [static]	возвращает максимально возможное количество элементов (открытая статическая функция-член)
resize	изменяет количество хранящихся элементов (открытая функция-член)
capacity [static]	возвращает количество элементов, которое может храниться в текущем выделенном хранилище (открытая статическая функция-член)
shrink_to_fit [static]	уменьшает использование памяти, освобождая неиспользуемую память (открытая статическая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/inplace_vector/reserve