std::hive<T,Allocator>::reshape

void reshape( std::hive_limits block_limits );

Перераспределяет элементы в каждом активном блоке, который не находится в пределах block_limits. Элементы перемещаются в новые или существующие блоки элементов, находящиеся в этих пределах.

Освобождает любые блоки элементов, находящиеся за пределами block_limits.

Если при выделении памяти для нового блока элементов возникает исключение, capacity() может быть уменьшена, может произойти перераспределение, а current-limits может получить значение, отличное от block_limits. В противном случае block_limits присваивается current-limits. Если возникает любое другое исключение, результат не определён.

Эта функция не изменяет size(), но может изменить capacity(). Если происходит перераспределение, порядок элементов в *this может измениться.

Перераспределение делает недействительными все ссылки, указатели и итераторы (включая end()), ссылающиеся на элементы в *this. Если перераспределение не происходит, они остаются действительными.

Параметры

Исключения

Любое исключение, возникающее при выделении памяти для нового блока элементов (обычно std::bad_alloc) или при конструировании элемента.

Сложность

Линейная относительно количества блоков элементов в *this. Если происходит перераспределение, сложность также линейна относительно количества перераспределённых элементов.

Пример

См. также