PHP - Ds\Queue::peek() 函数

PHP 的Ds\Queue::peek()函数用于检索队列前端的值，而不将其移除。队列的前端值指的是顶部值。如果当前队列为空([])，此函数将抛出“UnderflowException”异常。

语法

以下是PHP Ds\Queue::peek()函数的语法：

public Ds\Queue::peek(): mixed

参数

此函数不接受任何参数。

返回值

此函数返回队列前端的值。

示例1

以下是PHP Ds\Queue::peek()函数的基本示例：

<?php  
   $queue = new \Ds\Queue([10, 20, 30, 40, 50]);
   echo "The queue elements are: \n";
   print_r($queue);
   echo "The peek element in queue is: ";
   print_r($queue->peek());
?>

输出

上述程序产生以下输出：

The queue elements are:
Ds\Queue Object
(
    [0] => 10
    [1] => 20
    [2] => 30
    [3] => 40
    [4] => 50
)
The peek element in queue is: 10

示例2

以下是PHP Ds\Queue::peek()函数的另一个示例。我们使用此函数来检索此队列(["Tutorials", "Point", "India"]) 的顶部元素：

<?php  
   $queue = new \Ds\Queue(["Tutorials", "Point", "India"]);
   echo "The queue elements are: \n";
   print_r($queue);
   echo "The peek element in queue is: ";
   print_r($queue->peek());
?>

输出

执行上述程序后，将显示以下输出：

The queue elements are:
Ds\Queue Object
(
    [0] => Tutorials
    [1] => Point
    [2] => India
)
The peek element in queue is: Tutorials

示例3

如果当前队列为空([])，此函数将抛出“UnderflowException”异常：

<?php  
   $queue = new \Ds\Queue([]);
   echo "The queue elements are: \n";
   print_r($queue);
   echo "The peek element in queue is: ";
   print_r($queue->peek());
?>

输出

执行上述程序后，将抛出以下异常：

The queue elements are:
Ds\Queue Object
(
)
The peek element in queue is: PHP Fatal error:  Uncaught UnderflowException: 
Unexpected empty state in C:\Apache24\htdocs\index.php:6
Stack trace:
#0 C:\Apache24\htdocs\index.php(6): Ds\Queue->peek()
#1 {main}
  thrown in C:\Apache24\htdocs\index.php on line 6