Java中的队列add()方法

队列接口的add(E e)方法，如果有空间，则将参数中传入的元素插入到队列的末尾。如果 Queue 容量受限且没有空间可插入，则返回IllegalStateException 。该函数在成功插入时返回 true。

句法：

boolean add(E e)

参数：此方法接受一个强制参数e ，它是要插入到队列末尾的元素。

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

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

• ClassCastException ：当要输入的元素的类阻止它被添加到这个容器时。
• IllegalStateException ：当容器的容量已满并且插入完成时。
• IllegalArgumentException ：当元素的某些属性阻止将其添加到队列中时。
• NullPointerException : 当要插入的元素作为 null 传递并且队列的接口不允许 null 元素时。

下面的程序说明了 Queue 的 add() 方法：

程序 1：在LinkedList的帮助下。

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

输出：

Queue: [7855642, 35658786, 5278367, 74381793]

程序 2：在ArrayDeque的帮助下。

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

输出：

Queue: [7855642, 35658786, 5278367, 74381793]

程序 3：在LinkedBlockingDeque的帮助下。

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

输出：

Queue: [7855642, 35658786, 5278367, 74381793]

程序 4：在ConcurrentLinkedDeque的帮助下。

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

输出：

Queue: [7855642, 35658786, 5278367, 74381793]

下面的程序说明了此方法引发的异常：

程序 5：显示NullPointerException 。

// Java Program Demonstrate add()
// method of Queue when Null is passed
  
import java.util.*;
import java.util.concurrent.LinkedBlockingQueue;
  
public class GFG {
    public static void main(String[] args)
        throws IllegalStateException
    {
  
        // create object of Queue
        Queue Q
            = new LinkedBlockingQueue();
  
        // Add numbers to end of Queue
        Q.add(7855642);
        Q.add(35658786);
        Q.add(5278367);
  
        try {
            // when null is inserted
            Q.add(null);
        }
        catch (Exception e) {
            System.out.println("Exception: " + e);
        }
    }
}

输出：

Exception: java.lang.NullPointerException

程序 6：显示IllegalStateException 。

// Java Program Demonstrate add()
// method of Queue when capacity is full
import java.util.*;
import java.util.concurrent.LinkedBlockingQueue;
  
public class GFG {
    public static void main(String[] args)
        throws IllegalStateException
    {
  
        // create object of Queue
        Queue Q
            = new LinkedBlockingQueue(3);
  
        // Add numbers to end of Queue
        Q.add(7855642);
        Q.add(35658786);
        Q.add(5278367);
  
        try {
            // when capacity is full
            Q.add(10);
        }
        catch (Exception e) {
            System.out.println("Exception: " + e);
        }
    }
}

输出：

Exception: java.lang.IllegalStateException: Queue full

注意：其他两个异常是内部的，由编译器引起，因此无法在编译器中显示。

参考： https: Java/util/Queue.html#add-E-