Java中的ConcurrentLinkedDeque offerFirst()方法

java.util.concurrent.ConcurrentLinkedDeque.offerFirst()方法是Java中的内置方法，它将作为参数传递的指定元素插入到双端队列的前面。

语法:

Conn_Linked_Deque.offerFirst(Object elem)

参数: 该方法接受一个参数 elem 指定要插入到双端队列前面的元素。

返回值: 如果成功将元素添加到双端队列中，则函数返回True，否则返回False。

异常: 如果传递的参数为 NULL，则该函数会抛出NullPointerException。

以下程序说明了ConcurrentLinkedDeque.offerFirst()方法：

程序1: :

/* Java程序演示offerFirst()
   method of ConcurrentLinkedDeque */
  
import java.util.concurrent.*;
class GFG {
    public static void main(String[] args)
    {
  
        // 创建一个空Deque
        ConcurrentLinkedDeque<String> cld = 
                     new ConcurrentLinkedDeque<String>();
  
        // 将元素添加到双端队列中
        cld.add("Welcome");
        cld.add("To");
        cld.add("Geeks");
        cld.add("4");
        cld.add("Geeks");
  
        // 显示Deque中的元素
        System.out.println("Elements in Deque: "
                           + cld);
  
        // 显示第一个元素
        System.out.println("The First element is: " + 
                                       cld.getFirst());
  
        /* 在deque的前面插入一个元素 */
        if (cld.offerFirst("GFG")) {
            // 显示第一个元素
            System.out.println("The Inserted element is: " + 
                                             cld.getFirst());
        }
  
        // 显示Deque中的元素
        System.out.println("Elements in Deque: "
                           + cld);
  
        // 显示第一个元素
        System.out.println("The First element is: " + 
                                      cld.getFirst());
    }
}

Elements in Deque: [Welcome, To, Geeks, 4, Geeks]
The First element is: Welcome
The Inserted element is: GFG
Elements in Deque: [GFG, Welcome, To, Geeks, 4, Geeks]
The First element is: GFG

程序2:

/* Java程序展示ConcurrentLinkedDeque的offerFirst()方法*/
  
import java.util.concurrent.*;
class GFG {
    public static void main(String[] args)
    {
  
        // 创建空Deque
        ConcurrentLinkedDeque<Integer> cld =
                   new ConcurrentLinkedDeque<Integer>();
  
        // 在Deque中添加元素
        cld.add(12);
        cld.add(43);
        cld.add(29);
        cld.add(16);
        cld.add(70);
  
        // 显示Deque中的元素
        System.out.println("Deque中的元素: "
                           + cld);
  
        // 显示第一个元素
        System.out.println("第一个元素是: " + 
                                     cld.getFirst());
  
        try {
            cld.offerFirst(null);
        }
        catch (Exception e) {
            System.out.println(e);
        }
  
        /* 在Deque的前面插入元素 */
        if (cld.offerFirst(74)) {
            // 显示第一个元素
            System.out.println("插入的元素是: " + 
                                            cld.getFirst());
        }
  
        // 显示Deque中的元素
        System.out.println("Deque中的元素: "
                           + cld);
  
        // 显示第一个元素
        System.out.println("第一个元素是: " + 
                                      cld.getFirst());
    }
}

Deque中的元素: [12, 43, 29, 16, 70]
第一个元素是: 12
java.lang.NullPointerException
插入的元素是: 74
Deque中的元素: [74, 12, 43, 29, 16, 70]
第一个元素是: 74

参考链接： https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ConcurrentLinkedDeque.html#offerFirst()