Java - Queue offer(E) 方法

描述

Java Queue offer(E e) 方法在不违反容量限制的情况下，如果可以立即将指定的元素插入到此队列中，则插入该元素。当使用容量受限的队列时，此方法通常优于 add(E)，add(E) 只能通过抛出异常来失败插入元素。

声明

以下是 java.util.Queue.offer() 方法的声明

public boolean offer(E e)

参数

e − 要添加到末尾的元素。

返回值

如果元素已添加到此队列，则此方法返回 true，否则返回 false。

异常

ClassCastException − 如果指定元素的类阻止它添加到此队列

NullPointerException − 如果指定元素为空，并且此队列不允许空元素

IllegalArgumentException − 如果此元素的某些属性阻止它添加到此队列

示例 1

以下示例演示了使用整数的 Java Queue offer(E) 方法。我们使用 add() 方法将一些元素添加到列表中，然后使用 offer() 方法在末尾添加两个元素。最后，我们打印 Queue 对象以查看最终结果。

package com.tutorialspoint;

import java.util.LinkedList;
import java.util.Queue;

public class QueueDemo {
   public static void main(String[] args) {

      // create an empty queue
      Queue<Integer> queue = new LinkedList<>();

      // use add() method to add elements in the queue
      queue.add(1);
      queue.add(2);
      queue.add(3);
      queue.add(4);        
      queue.add(5);
      queue.add(6);

      // the values will be printed in the same order
      queue.offer(7);
      queue.offer(8);

      // let us print all the elements available in queue
      System.out.println("Queue = " + queue);      
   }
}

输出

让我们编译并运行上述程序，这将产生以下结果：

Queue = [1, 2, 3, 4, 5, 6, 7, 8]

示例 2

以下示例演示了使用字符串的 Java Queue offer(E) 方法。我们使用 add() 方法将一些元素添加到列表中，然后使用 offer() 方法在末尾添加两个元素。最后，我们打印 Queue 对象以查看最终结果。

package com.tutorialspoint;

import java.util.LinkedList;
import java.util.Queue;

public class QueueDemo {
   public static void main(String[] args) {

      // create an empty queue
      Queue<String> queue = new LinkedList<>();

      // use add() method to add elements in the queue
      queue.add("A");
      queue.add("B");
      queue.add("C");
      queue.add("D");        
      queue.add("E");
      queue.add("F");

      // the values will be printed in the same order
      queue.offer("G");
      queue.offer("H");

      // let us print all the elements available in queue
      System.out.println("Queue = " + queue);      
   }
}

输出

让我们编译并运行上述程序，这将产生以下结果：

Queue = [A, B, C, D, E, F, G, H]

示例 3

以下示例演示了使用 Student 对象的 Java Queue offer(E) 方法。我们使用 add() 方法将一些元素添加到列表中，然后使用 offer() 方法在末尾添加两个元素。最后，我们打印 Queue 对象以查看最终结果。

package com.tutorialspoint;

import java.util.LinkedList;
import java.util.Queue;

public class QueueDemo {
   public static void main(String[] args) {

      // create an empty queue
      Queue<Student> queue = new LinkedList<>();

      // use add() method to add elements in the queue
      queue.add(new Student(1, "Julie"));
      queue.add(new Student(2, "Robert"));
      queue.add(new Student(3, "Adam"));

      // use offer() method to add element at the end of the queue
      queue.offer(new Student(4, "Rohan"));
      queue.offer(new Student(5, "Sohan"));

      // let us print all the elements available in queue
      System.out.println("Queue = " + queue);      
   }
}

class Student {
   int rollNo;
   String name;

   Student(int rollNo, String name){
      this.rollNo = rollNo;
      this.name = name;
   }

   @Override
   public String toString() {
      return "[ " + this.rollNo + ", " + this.name + " ]";
   }
}

输出

让我们编译并运行上述程序，这将产生以下结果：

Queue = [[ 1, Julie ], [ 2, Robert ], [ 3, Adam ], [ 4, Rohan ], [ 5, Sohan ]]