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 ]]