Ds\Stack::allocate()
强制设置 Stack 的容量大小
函数名称：Ds\Stack::allocate()
适用版本：使用 PHP 扩展库 Ds 版本 1.0.0 或更高版本。
用法：Ds\Stack::allocate() 方法用于强制设置 Stack 的容量大小。
语法：public function allocate(int $capacity): void
参数：
$capacity：表示 Stack 的容量大小，必须是一个非负整数。
返回值：该方法没有返回值。
示例：
<?php
// 创建一个空的 Stack 对象
$stack = new Ds\Stack();
// 设置 Stack 的容量大小为10
$stack->allocate(10);
// 添加元素到 Stack
$stack->push(1);
$stack->push(2);
$stack->push(3);
// 打印 Stack 的内容
print_r($stack);
?>
输出：
Ds\Stack Object
(
[0] => 1
[1] => 2
[2] => 3
)
说明：
使用 allocate() 方法可以为 Stack 对象提前分配一定的存储空间，以提高性能和效率。
在示例中，我们创建了一个空的 Stack 对象，并使用 allocate() 方法将其容量设置为 10。
然后，我们向 Stack 中添加了三个元素：1，2 和 3。
最后，我们使用 print_r() 函数打印了 Stack 对象的内容，可以看到成功添加了三个元素。