Home » Java programming language

Java PriorityQueue offer() Method with Example

PriorityQueue Class offer() method: Here, we are going to learn about the offer() method of PriorityQueue Class with its syntax and example.
Submitted by Preeti Jain, on March 11, 2020

PriorityQueue Class offer() method

• offer() method is available in java.util package.
• offer() method is used to add the given element (ele) into this PriorityQueue.
• offer() method is a non-static method, it is accessible with the class object only and if we try to access the method with the class name then we will get an error.
• offer() method may throw an exception at the time of adding the given element (ele).
  • ClassCastException: This exception may throw when the given element is incompatible to compare with.
  • NullPointerException: This exception may throw when the given parameter is null exists.

Syntax:

    public boolean offer(Element ele);

Parameter(s):

• Element ele – represents the element (ele) to be added into this PriorityQueue.

Return value:

The return type of the method is boolean, it returns true when the given element is to be added successfully otherwise it returns false.

Example:

// Java program to demonstrate the example 
// of boolean offer(Element ele) method of 
// PriorityQueue

import java.util.*;

public class OfferOfPriorityQueue {
    public static void main(String args[]) {
        // Instantiate PriorityQueue
        PriorityQueue < String > pq = new PriorityQueue < String > ();

        // By using add() method is add
        // the given element into priority
        // queue
        pq.add("C");
        pq.add("C++");
        pq.add("JAVA");
        pq.add("PHP");
        pq.add("ANDROID");

        // Display PriorityQueue
        System.out.println("PriorityQueue: " + pq);

        // By using offer() method is used to
        // add the given object if not exists 
        // in this PriorityQueue
        boolean status = pq.offer("Microservices");

        // Display status of PriorityQueue
        System.out.println("pq.offer(Microservices): " + status);

        // Display PriorityQueue
        System.out.println("PriorityQueue: " + pq);
    }
}

Output

PriorityQueue: [ANDROID, C, JAVA, PHP, C++]
pq.offer(Microservices): true
PriorityQueue: [ANDROID, C, JAVA, PHP, C++, Microservices]