Skip to content
Related Articles

Related Articles

Queue.Peek Method in C#
  • Last Updated : 04 Feb, 2019

This method returns the object at the beginning of the Queue without removing it. This method is similar to the Dequeue method, but Peek does not modify the Queue and is an O(1) operation. This method comes under System.Collections namespace.

Syntax:

public virtual object Peek ();

Return Value: The object at the beginning of the Queue.

Exception: This method will give InvalidOperationException if the Queue is empty.

Below programs illustrate the use of above-discussed method:



Example 1:




// C# code to illustrate the
// Queue.Peek Method
using System;
using System.Collections;
  
class GFG {
  
    // Driver code
    public static void Main()
    {
  
        // Creating a Queue
        Queue myQueue = new Queue();
  
        // Inserting the elements into the Queue
        myQueue.Enqueue("1st Element");
        myQueue.Enqueue("2nd Element");
        myQueue.Enqueue("3rd Element");
        myQueue.Enqueue("4th Element");
        myQueue.Enqueue("5th Element");
        myQueue.Enqueue("6th Element");
  
        // Displaying the count of elements
        // contained in the Queue
        Console.Write("Total number of elements in the Queue are : ");
  
        Console.WriteLine(myQueue.Count);
  
        // Displaying the beginning element of Queue
        // without removing it from the Queue
        Console.WriteLine("Element at the beginning is : " 
                                        + myQueue.Peek());
  
        // Displaying the beginning element of Queue
        // without removing it from the Queue
        Console.WriteLine("Element at the beginning is : " 
                                        + myQueue.Peek());
  
        // Displaying the count of elements
        // contained in the Queue
        Console.Write("Total number of elements in the Queue are : ");
  
        Console.WriteLine(myQueue.Count);
    }
}

Output:

Total number of elements in the Queue are : 6
Element at the beginning is : 1st Element
Element at the beginning is : 1st Element
Total number of elements in the Queue are : 6

Example 2:




// C# code to illustrate the
// Queue.Peek Method
using System;
using System.Collections;
  
class GFG {
  
    // Driver code
    public static void Main()
    {
  
        // Creating a Queue
        Queue myQueue = new Queue();
  
        // Displaying the beginning element of Queue
        // without removing it from the Queue
        // Calling Peek() method on empty Queue
        // will throw InvalidOperationException.
        Console.WriteLine("Element at the beginning is : "
                                       + myQueue.Peek());
    }
}

Runtime Error:

Unhandled Exception:
System.InvalidOperationException: Queue empty.

Reference:

Attention reader! Don’t stop learning now. Get hold of all the important DSA concepts with the DSA Self Paced Course at a student-friendly price and become industry ready.

My Personal Notes arrow_drop_up
Recommended Articles
Page :