Java - Deque offerFirst(E) 方法

Java Deque offerFirst(E e) 方法将指定的元素 E 插入到此 deque 的开头。它类似于 addFirst() 方法。

声明

以下是 java.util.Deque.offerFirst() 方法的声明

public boolean offerFirst(E e)

参数

e - 要添加到开头的元素。

返回值

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

异常

ClassCastException - 如果指定元素的类阻止其添加到此 deque。

NullPointerException - 如果指定元素为 null，并且此 deque 不允许 null 元素。

IllegalArgumentException - 如果指定元素的某些属性阻止其添加到此 deque。

示例 1

以下示例显示了 Java Deque offerFirst(E) 方法的使用。在此示例中，我们使用整数。首先，我们将使用 add() 方法将一些项添加到 deque，然后使用 offerFirst() 方法，我们将元素添加到 deque 的开头。然后我们再次使用 add() 方法添加更多元素，并打印数组以检查 deque 中的插入是否按我们期望的顺序进行。

package com.tutorialspoint;

import java.util.ArrayDeque;
import java.util.Deque;

public class DequeDemo {
   public static void main(String[] args) {
      
      // create an empty deque
      Deque<Integer> deque = new ArrayDeque<>();

      // use add() method to add elements in the deque
      deque.add(4);
      deque.add(5);
      deque.add(6);

      // use offerFirst() method to add element at the front of the deque
      deque.offerFirst(3);
      deque.offerFirst(2);
      deque.offerFirst(1);//now, element 1 will be at the front

      // these elements will be added in continuation with deque.add(6)
      deque.add(7);
      deque.add(8);

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

输出

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

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

示例 2

以下示例显示了 Java Deque offerFirst(E) 方法的使用。在此示例中，我们使用字符串。首先，我们将使用 add() 方法将一些项添加到 deque，然后使用 offerFirst() 方法，我们将元素添加到 deque 的开头。然后我们再次使用 add() 方法添加更多元素，并打印数组以检查 deque 中的插入是否按我们期望的顺序进行。

package com.tutorialspoint;

import java.util.ArrayDeque;
import java.util.Deque;

public class DequeDemo {
   public static void main(String[] args) {
      
      // create an empty array deque
      Deque<String> deque = new ArrayDeque<>();

      // use add() method to add elements in the deque
      deque.add("D");
      deque.add("E");
      deque.add("F");

      // use offerFirst() method to add element at the front of the deque
      deque.offerFirst("C");
      deque.offerFirst("B");
      deque.offerFirst("A");//now, element A will be at the front

      // these elements will be added in continuation with deque.add("F")
      deque.add("G");
      deque.add("H");

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

输出

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

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

示例 3

以下示例显示了 Java Deque offerFirst(E) 方法的使用。在此示例中，我们使用 Student 对象。首先，我们将使用 add() 方法将一些项添加到 deque，然后使用 offerFirst() 方法，我们将元素添加到 deque 的开头。然后我们再次使用 add() 方法添加更多元素，并打印数组以检查 deque 中的插入是否按我们期望的顺序进行。

package com.tutorialspoint;

import java.util.ArrayDeque;
import java.util.Deque;

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

      // create an empty array deque
      Deque<Student> deque = new ArrayDeque<>();

      // use add() method to add elements in the deque
      deque.add(new Student(4, "Julie"));
      deque.add(new Student(5, "Robert"));
      deque.add(new Student(6, "Adam"));

      // use offerFirst() method to add element at the front of the deque
      deque.offerFirst(new Student(3, "Rohan"));
      deque.offerFirst(new Student(2, "Sohan"));
      deque.offerFirst(new Student(1, "Mohan"));//now, Student 1 will be at the front

      // these elments will be added in continuation with deque.add(new Student(6, "Adam"))
      deque.add(new Student(7, "Ali"));
      deque.add(new Student(8, "Ahmad"));

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

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 + " ]";
   }
}

输出

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

Deque = [[ 1, Mohan ], [ 2, Sohan ], [ 3, Rohan ], [ 4, Julie ], [ 5, Robert ], [ 6, Adam ], [ 7, Ali ], [ 8, Ahmad ]]