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

函式: Ds\Deque::first()

適用版本: PHP 7.1.0 及以上版本

用法: Ds\Deque::first() 函式用於返回雙向佇列（Deque）的第一個元素，但並不會將其從佇列中移除。

示例:

$deque = new Ds\Deque([1, 2, 3, 4, 5]);
$firstElement = $deque->first();

var_dump($firstElement); // 輸出: int(1)

// 原雙向佇列保持不變
var_dump($deque->toArray()); // 輸出: array(5) { [0]=> int(1) [1]=> int(2) [2]=> int(3) [3]=> int(4) [4]=> int(5) }

在上面的示例中，我們建立了一個雙向佇列，並使用new Ds\Deque([1, 2, 3, 4, 5])初始化了它。然後，我們使用first()函式來獲取第一個元素，即 1。注意，這個元素在佇列中保留，沒有被移除。最後，我們使用toArray()方法來驗證原雙向佇列的不變性。

請注意，使用該函式之前需要先安裝並啟用Ds擴充套件，該擴充套件需要透過 PECL 安裝，或者在 PHP 7.2.0 之後的版本中，可以使用 composer 進行安裝。