Выделяет память под указанную вместимость

# Ds\Queue::allocate

(PECL ds >= 1.0.0)

Ds\Queue::allocate — Выделяет память под указанную вместимость

### Описание

public function Ds\Queue::allocate(int `$capacity`): void

Гарантирует, что выделено достаточно памяти под заданную вместимость (количество значений). Позволяет избежать динамического перераспределения внутреннего буфера при добавлении значений.

> Замечание:

> Значение вместимости округляется до ближайшей степени двойки (т.е. 8, 16, 32, 64, 128 и т.д.)

### Список параметров

`capacity`

  Вместимость. Предполагаемое количество значений.

  > Замечание:

  > Если новое значение вместимости меньше текущего, то она не изменится.

  > Замечание:

  > Значение вместимости округляется до ближайшей степени двойки (т.е. 8, 16, 32, 64, 128 и т.д.)

### Возвращаемые значения

Функция не возвращает значения после выполнения.

### Примеры

Пример #1 Пример использования Ds\Queue::allocate()

    <?php
    $queue = new \Ds\Queue();
    var_dump($queue->capacity());

    $queue->allocate(100);
    var_dump($queue->capacity());
    ?>

Вывод приведённого примера будет похож на:

    int(8)
    int(128)

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open