Ds\Deque::allocate

(PECL ds >= 1.0.0)

Ds\Deque::allocate — Allocates enough memory for a required capacity

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

Ensures that enough memory is allocated for a required capacity. This removes the need to reallocate the internal buffer as values are added.

capacity: The number of values for which capacity should be allocated.

Note:
Capacity will stay the same if this value is less than or equal to the current capacity.

Note:
Capacity will always be rounded up to the nearest power of 2.

No value is returned.

Example #1 Ds\Deque::allocate() example

<?php
$deque = new \Ds\Deque();
var_dump($deque->capacity());

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

The above example will output something similar to:

int(8)
int(128)