The Wayback Machine - https://web.archive.org/web/20230422233150/https://www.geeksforgeeks.org/php-dsqueue-peek-function/
Skip to content
Related Articles
Get the best out of our app
GFG App
Open App
geeksforgeeks
Browser
Continue

Related Articles

PHP Ds\Queue peek() Function

Improve Article
Save Article
Like Article
author
gopaldave
scholar
1293 published articles
Improve Article
Save Article
Like Article

The Ds\Queue::peek() Function in PHP is used to get the value present at the front of a Queue. This function simply returns the element present at the front of a Queue instance without actually removing it.

Syntax:

mixed public Ds\Queue::peek ( void )

Parameters: This function does not accepts any parameters.

Return Value: This function returns the value present at the front of this Queue. The return type of the function is mixed and depends on the type of value stored in the Queue.

Exception: This function throws an UnderflowException if the Queue is empty.

Below programs illustrate the Ds\Queue::peek() Function in PHP

Program 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());
  
?> 

Output:

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

Element at front is: One

Program 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());
  
?> 

Output:

PHP Fatal error:  Uncaught UnderflowException

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


My Personal Notes arrow_drop_up
Last Updated : 23 Aug, 2019
Like Article
Save Article
Similar Reads