PHP | Ds\Deque first()函数

简介

Ds\Deque first(): mixed 函数用于获取双向队列的第一个元素。

语法

deque->first(): mixed

返回值

如果双向队列不为空，则返回第一个元素；否则返回null。

示例

<?php

$deque = new \Ds\Deque([1, 2, 3]);

$first = $deque->first();
echo $first; // 1

$deque->shift();
$first = $deque->first();
echo $first; // 2

$deque->clear();
$first = $deque->first();
var_dump($first); // null

?>

注意事项

• Ds\Deque::__construct() 构造函数中的参数必须是可迭代对象。
• 如果双向队列为空，调用该函数会返回null，所以在使用之前应该进行非空判断。
• 该方法并不会从双向队列中删除第一个元素，如果需要删除第一个元素，应该使用 Ds\Deque::shift() 函数。

参考链接

• PHP官方文档