Función PHP Ds\\PriorityQueue peek()

La función Ds\PriorityQueue::peek() en PHP se usa para obtener el valor presente al principio de PriorityQueue.

Sintaxis:

mixed public Ds\PriorityQueue::peek ( void )

Parámetros: Esta función no acepta ningún parámetro.

Valor devuelto: esta función devuelve el valor presente al principio de esta PriorityQueue. El tipo de retorno de la función es mixto y depende del tipo de valor almacenado en PriorityQueue.

Excepción : esta función lanza una UnderflowException si PriorityQueue está vacío.

Los siguientes programas ilustran Ds\PriorityQueue::peek():

Programa 1:

<?php 
  
// Declare new PriorityQueue 
$pq = new \Ds\PriorityQueue(); 
  
// Add elements to the PriorityQueue
$pq->push("One", 1);
$pq->push("Two", 2);
$pq->push("Three", 3);
  
echo "PriorityQueue is: \n";
print_r($pq);
  
// Get element at the front
echo "\nElement at front is: ";
print_r($pq->peek());
  
?> 

PriorityQueue is: 
Ds\PriorityQueue Object
(
    [0] => Three
    [1] => Two
    [2] => One
)

Element at front is: Three

Programa 2:

<?php 
  
// Declare new PriorityQueue 
$pq = new \Ds\PriorityQueue(); 
  
echo "PriorityQueue is: \n";
print_r($pq);
  
// Get element at the front
echo "\nElement at front is: ";
print_r($pq->peek());
  
?> 

PHP Fatal error:  Uncaught UnderflowException

Referencia: http://php.net/manual/en/ds-priorityqueue.peek.php