Java Stack retainAll()方法及实例

java.util.Stack 类的 retainAll() 方法用于保留该堆栈中包含在指定集合中的所有元素。

语法

public boolean retainAll(Collection c)

参数： 该方法以集合c为参数，包含要从这个堆栈中保留的元素。

返回值： 如果这个堆栈由于调用而发生了变化，该方法返回true。

异常： 如果这个堆栈包含一个空元素，而指定的集合不允许空元素（可选），或者指定的集合是空的，这个方法会抛出 NullPointerException 。

下面是一些例子来说明 retainAll() 方法。

例1 :

// Java program to demonstrate
// retainAll() method for Integer value
  
import java.util.*;
  
public class GFG1 {
    public static void main(String[] argv) throws Exception
    {
  
        try {
  
            // Creating object of Stack<Integer>
            Stack<Integer>
                stack1 = new Stack<Integer>();
  
            // Populating stack1
            stack1.add(1);
            stack1.add(2);
            stack1.add(3);
            stack1.add(4);
            stack1.add(5);
  
            // print stack1
            System.out.println("Stack before "
                               + "retainAll() operation : "
                               + stack1);
  
            // Creating another object of  Stack<Integer>
            Stack<Integer>
                stack2 = new Stack<Integer>();
            stack2.add(1);
            stack2.add(2);
            stack2.add(3);
  
            // print stack2
            System.out.println("Collection Elements"
                               + " to be retained : "
                               + stack2);
  
            // Removing elements from stack
            // specified in stack2
            // using retainAll() method
            stack1.retainAll(stack2);
  
            // print stack1
            System.out.println("Stack after "
                               + "retainAll() operation : "
                               + stack1);
        }
  
        catch (NullPointerException e) {
            System.out.println("Exception thrown : " + e);
        }
    }
}

输出：

Stack before retainAll() operation : [1, 2, 3, 4, 5]
Collection Elements to be retained : [1, 2, 3]
Stack after retainAll() operation : [1, 2, 3]

例2： 对于NullPointerException

// Java program to demonstrate
// retainAll() method for Integer value
  
import java.util.*;
  
public class GFG1 {
    public static void main(String[] argv) throws Exception
    {
  
        try {
  
            // Creating object of Stack<Integer>
            Stack<Integer>
                stack1 = new Stack<Integer>();
  
            // Populating stack1
            stack1.add(1);
            stack1.add(2);
            stack1.add(3);
            stack1.add(4);
            stack1.add(5);
  
            // print stack1
            System.out.println("Stack before "
                               + "retainAll() operation : "
                               + stack1);
  
            // Creating another object of  Stack<Integer>
            Stack<Integer>
                stack2 = null;
  
            // print stack2
            System.out.println("Collection Elements"
                               + " to be retained : "
                               + stack2);
  
            System.out.println("\nTrying to pass "
                               + "null as a specified element\n");
  
            // Removing elements from stack
            // specified in stack2
            // using retainAll() method
            stack1.retainAll(stack2);
  
            // print stack1
            System.out.println("Stack after "
                               + "retainAll() operation : "
                               + stack1);
        }
  
        catch (NullPointerException e) {
            System.out.println("Exception thrown : " + e);
        }
    }
}

输出：

Stack before retainAll() operation : [1, 2, 3, 4, 5]
Collection Elements to be retained : null

Trying to pass null as a specified element

Exception thrown : java.lang.NullPointerException