Ds\Sequence::allocate()
为序列分配指定大小的内存
函数名称：Ds\Sequence::allocate()
适用版本：PHP 7.3.0 及以上
用法：该函数用于为序列分配指定大小的内存。
语法：
public function allocate(int $capacity): void
参数：
$capacity: 分配的内存大小，必须大于当前序列的元素数量。如果指定的大小小于当前序列的元素数量，则会删除多余的元素。
返回值：该函数没有返回值。
示例：
// 创建一个空的集合
$sequence = new Ds\Sequence();
// 添加元素到集合中
$sequence->push(1);
$sequence->push(2);
$sequence->push(3);
$sequence->push(4);
// 输出集合的元素数量
echo "元素数量：" . count($sequence) . "\n";
// Output: 元素数量：4
// 分配额外的内存
$sequence->allocate(8);
// 输出集合的元素数量
echo "元素数量：" . count($sequence) . "\n";
// Output: 元素数量：4
// 添加更多元素到集合中
$sequence->push(5);
$sequence->push(6);
$sequence->push(7);
$sequence->push(8);
$sequence->push(9);
$sequence->push(10);
// 输出集合的元素数量
echo "元素数量：" . count($sequence) . "\n";
// Output: 元素数量：10
在上述示例中，我们首先创建了一个空的序列，并使用push()方法添加了四个元素。然后，我们使用allocate()函数分配了额外的内存空间，但由于指定的大小小于当前序列的元素数量，所以不会有任何改变。最后，我们继续添加更多的元素到序列中，这时候序列的元素数量变为10。