Ds\Deque::capacity()函式—用法及示例

函式名：Ds\Deque::capacity()

適用版本：PHP 7.1以上

用法：該函式用於獲取雙向佇列（Deque）的容量大小。

示例：

// 建立一個雙向佇列
$deque = new Ds\Deque([1, 2, 3]);

// 獲取雙向佇列的容量大小
$capacity = $deque->capacity();

echo $capacity; // 輸出：7

在上面的示例中，我們首先建立了一個雙向佇列，並初始化了一些元素。然後使用capacity()函式獲取雙向佇列的容量大小，並將結果賦值給變數$capacity。最後，我們將容量大小列印出來，預期輸出為7。

需要注意的是，雙向佇列的容量指的是其內部緩衝區的大小，而不是佇列中實際儲存的元素數量。在初始化雙向佇列時，會為其分配一個預設的容量。當佇列的元素數量超過容量時，會自動進行擴容。