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 进行安装。