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()方法。另外，當向量的容量不足時，會自動進行記憶體擴充套件以容納更多元素。