Función PHP Ds\\Queue peek()

La función Ds\Queue::peek() en PHP se usa para obtener el valor presente al principio de una cola. Esta función simplemente devuelve el elemento presente al frente de una instancia de Queue sin eliminarlo realmente.

Sintaxis:

mixed public Ds\Queue::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 cola. El tipo de retorno de la función es mixto y depende del tipo de valor almacenado en la Cola.

Excepción : esta función arroja una UnderflowException si la cola está vacía.

Los siguientes programas ilustran la función Ds\Queue::peek() en PHP

Programa 1:

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

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

Element at front is: One

Programa 2:

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

PHP Fatal error:  Uncaught UnderflowException

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