Close

Java Collections - PriorityQueue.offer() Examples

[Last Updated: Dec 11, 2025]

Java Collections Java Java API 


Class:

java.util.PriorityQueue

java.lang.Objectjava.lang.Objectjava.util.AbstractCollectionjava.util.AbstractCollectionjava.util.CollectionCollectionjava.util.AbstractQueuejava.util.AbstractQueuejava.util.QueueQueuejava.util.PriorityQueuejava.util.PriorityQueuejava.io.SerializableSerializableLogicBig

Method:

public boolean offer(E e)

Inserts the specified element into this priority queue. As PriorityQueue is not a capacity-restricted queue, this method always returns true.


Examples


package com.logicbig.example.priorityqueue;

import java.util.PriorityQueue;

public class OfferExample {

public static void main(String... args) {
PriorityQueue<String> pq = new PriorityQueue<>();
boolean b = pq.offer("one");
System.out.println(b);
b = pq.offer("two");
System.out.println(b);
System.out.println(pq);
}
}

Output

true
true
[one, two]
JDK 25




PriorityQueue does not allow null elements:

package com.logicbig.example.priorityqueue;

import java.util.PriorityQueue;

public class OfferExample2 {

public static void main(String... args) {
PriorityQueue<String> pq = new PriorityQueue<>();
pq.offer(null);
}
}

Output

java.lang.NullPointerException
at java.util.PriorityQueue.offer (PriorityQueue.java:325)
at com.logicbig.example.priorityqueue.OfferExample2.main (OfferExample2.java:15)
at jdk.internal.reflect.DirectMethodHandleAccessor.invoke (DirectMethodHandleAccessor.java:104)
at java.lang.reflect.Method.invoke (Method.java:565)
at org.codehaus.mojo.exec.AbstractExecJavaBase.executeMainMethod (AbstractExecJavaBase.java:402)
at org.codehaus.mojo.exec.ExecJavaMojo.executeMainMethod (ExecJavaMojo.java:142)
at org.codehaus.mojo.exec.AbstractExecJavaBase.doExecClassLoader (AbstractExecJavaBase.java:377)
at org.codehaus.mojo.exec.AbstractExecJavaBase.lambda$execute$0 (AbstractExecJavaBase.java:287)
at java.lang.Thread.run (Thread.java:1474)
JDK 25




See Also