Home/ Manual/ ds / queue/ Ds\Queue::allocate

Ds\Queue::allocate

PHP function Edit on GitHub ✎

(PECL ds >= 1.0.0)

Allocates enough memory for a required capacity

Description

Ds\Queue::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.

Note

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

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.

Void

php

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

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

The above example will output something similar to:

output

int(8)
int(128)

Source: reference/ds/ds/queue/allocate.xml · from the official PHP manual (php/doc-en)