Ds\Vector::capacity()
获取当前向量的容量大小，即向量在不重新分配内存的情况下可以容纳的元素数量
函数名：Ds\Vector::capacity()
适用版本：PHP 7.0及以上
用法：该函数用于获取当前向量的容量大小，即向量在不重新分配内存的情况下可以容纳的元素数量。
示例：
<?php
$vector = new Ds\Vector([1, 2, 3, 4, 5]);
$capacity = $vector->capacity();
echo "Vector capacity: " . $capacity . PHP_EOL;
$vector->push(6);
$capacity = $vector->capacity();
echo "Updated vector capacity: " . $capacity . PHP_EOL;
?>
输出：
Vector capacity: 5
Updated vector capacity: 5
在示例中，我们首先创建一个包含5个元素的向量。然后，通过调用capacity()方法，我们获取了向量的容量大小，并将其打印出来。接下来，我们向向量中添加一个新元素，并再次调用capacity()方法来获取更新后的容量大小。最终，我们以字符串形式输出了容量值。
需要注意的是，capacity()方法只返回当前容量大小，并不表示向量中实际存在的元素个数。要获取向量的元素个数，可以使用count()方法。另外，当向量的容量不足时，会自动进行内存扩展以容纳更多元素。