Java Deque add()方法

Deque接口的 add(E e) 方法在有空间的情况下将参数中传递的元素插入到Deque的末端。如果Deque有容量限制，没有空间可以插入，它将返回 IllegalStateException。 如果插入成功，该函数返回true。

语法

boolean add(E e)

参数： 该方法接受一个强制性参数 e ，它是要插入到Deque末端的元素。

返回： 该方法在成功插入时返回true。

异常： 该函数抛出了四个异常，描述如下。

下面的程序说明了Deque的add()方法。

程序1： 在 LinkedList 的帮助下 。

// Java Program Demonstrate add()// method of Dequeimport java.util.*; public class GFG {    public static void main(String[] args)        throws IllegalStateException    {         // create object of De1ue        Deque<Integer> DQ            = new LinkedList<Integer>();         // Add numbers to end of Deque        DQ.add(7855642);        DQ.add(35658786);        DQ.add(5278367);        DQ.add(74381793);         // before removing print Deque        System.out.println("Deque: " + DQ);    }}

输出

Deque: [7855642, 35658786, 5278367, 74381793]

程序2： 在 ArrayDeque 的帮助下 。

// Java Program Demonstrate add()// method of Dequeimport java.util.*; public class GFG {    public static void main(String[] args)        throws IllegalStateException    {         // create object of De1ue        Deque<Integer> DQ            = new ArrayDeque<Integer>();         // Add numbers to end of Deque        DQ.add(7855642);        DQ.add(35658786);        DQ.add(5278367);        DQ.add(74381793);         // before removing print Deque        System.out.println("Deque: " + DQ);    }}

输出

Deque: [7855642, 35658786, 5278367, 74381793]

程序3： 在 ConcurrentLinkedDeque 的帮助下 。

// Java Program Demonstrate add()// method of Dequeimport java.util.*;import java.util.concurrent.ConcurrentLinkedDeque; public class GFG {    public static void main(String[] args)        throws IllegalStateException    {         // create object of De1ue        Deque<Integer> DQ            = new ConcurrentLinkedDeque<Integer>();         // Add numbers to end of Deque        DQ.add(7855642);        DQ.add(35658786);        DQ.add(5278367);        DQ.add(74381793);         // before removing print Deque        System.out.println("Deque: " + DQ);    }}

输出

Deque: [7855642, 35658786, 5278367, 74381793]

程序4： 在 LinkedBlockingDeque 的帮助下 。

// Java Program Demonstrate add()// method of Dequeimport java.util.*;import java.util.concurrent.LinkedBlockingDeque; public class GFG {    public static void main(String[] args)        throws IllegalStateException    {         // create object of De1ue        Deque<Integer> DQ            = new LinkedBlockingDeque<Integer>();         // Add numbers to end of Deque        DQ.add(7855642);        DQ.add(35658786);        DQ.add(5278367);        DQ.add(74381793);         // before removing print Deque        System.out.println("Deque: " + DQ);    }}

输出

Deque: [7855642, 35658786, 5278367, 74381793]

下面的程序说明了 由add()方法抛出的异常。

程序5： 显示 NullPointerException。

/// Java Program Demonstrate add()// method of DeQue when Null is passedimport java.util.*;import java.util.concurrent.LinkedBlockingDeque; public class GFG {    public static void main(String[] args)        throws IllegalStateException    {         // create object of DeQue        Deque<Integer> DQ            = new LinkedBlockingDeque<Integer>();         // Add numbers to end of DeQue        DQ.add(7855642);        DQ.add(35658786);        DQ.add(5278367);        // when null is inserted        DQ.add(null);         // before removing print DeQue        System.out.println("DeQue: " + DQ);    }}

输出

Exception in thread "main" java.lang.NullPointerException    at java.util.concurrent.LinkedBlockingDeque.offerLast(LinkedBlockingDeque.java:357)    at java.util.concurrent.LinkedBlockingDeque.addLast(LinkedBlockingDeque.java:334)    at java.util.concurrent.LinkedBlockingDeque.add(LinkedBlockingDeque.java:633)    at GFG.main(GFG.java:20)

程序6： 显示 IllegalStateException .

// Java Program Demonstrate add()// method of Deque when capacity is fullimport java.util.*;import java.util.concurrent.LinkedBlockingDeque; public class GFG {    public static void main(String[] args)        throws IllegalStateException    {         // create object of Deque        Deque<Integer> DQ            = new LinkedBlockingDeque<Integer>(3);         // Add numbers to end of Deque        DQ.add(7855642);        DQ.add(35658786);        DQ.add(5278367);         // when capacity is full        DQ.add(10);         // before removing print Deque        System.out.println("Deque: " + DQ);    }}

输出

Exception in thread "main" java.lang.IllegalStateException: Deque full    at java.util.concurrent.LinkedBlockingDeque.addLast(LinkedBlockingDeque.java:335)    at java.util.concurrent.LinkedBlockingDeque.add(LinkedBlockingDeque.java:633)    at GFG.main(GFG.java:21)

注意： 另外两个异常是内部的，是根据编译器引起的，因此不能在编译器中显示。

参考资料 ：https://docs.oracle.com/javase/8/docs/api/java/util/Deque.html#add-E-