El método retainAll() de la clase java.util.LinkedHashSet se usa para retener de este conjunto todos sus elementos que están contenidos en la colección especificada.
Sintaxis:
public boolean retainAll(Collection c)
Parámetros: este método toma la colección c como un parámetro que contiene elementos que se conservarán de este conjunto.
Valor devuelto: este método devuelve verdadero si este conjunto cambió como resultado de la llamada.
Excepción: este método lanza NullPointerException si este conjunto contiene un elemento nulo y la colección especificada no permite elementos nulos (opcional), o si la colección especificada es nula.
A continuación se muestran los ejemplos para ilustrar el método de retención() .
Ejemplo 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 LinkedHashSet<Integer>
LinkedHashSet<Integer>
set1 = new LinkedHashSet<Integer>();
// Populating set1
set1.add(1);
set1.add(2);
set1.add(3);
set1.add(4);
set1.add(5);
// print set1
System.out.println("LinkedHashSet before "
+ "retainAll() operation : "
+ set1);
// Creating another object of LinkedHashSet<Integer>
LinkedHashSet<Integer>
set2 = new LinkedHashSet<Integer>();
set2.add(1);
set2.add(2);
set2.add(3);
// print set2
System.out.println("Collection Elements"
+ " to be retained : "
+ set2);
// Removing elements from set
// specified in set2
// using retainAll() method
set1.retainAll(set2);
// print set1
System.out.println("LinkedHashSet after "
+ "retainAll() operation : "
+ set1);
}
catch (NullPointerException e) {
System.out.println("Exception thrown : " + e);
}
}
}
Producción:
LinkedHashSet before retainAll() operation : [1, 2, 3, 4, 5] Collection Elements to be retained : [1, 2, 3] LinkedHashSet after retainAll() operation : [1, 2, 3]
Ejemplo 2: para 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 LinkedHashSet<Integer>
LinkedHashSet<Integer>
set1 = new LinkedHashSet<Integer>();
// Populating set1
set1.add(1);
set1.add(2);
set1.add(3);
set1.add(4);
set1.add(5);
// print set1
System.out.println("LinkedHashSet before "
+ "retainAll() operation : "
+ set1);
// Creating another object of LinkedHashSet<Integer>
LinkedHashSet<Integer>
set2 = null;
// print set2
System.out.println("Collection Elements"
+ " to be retained : "
+ set2);
System.out.println("\nTrying to pass "
+ "null as a specified element\n");
// Removing elements from set
// specified in set2
// using retainAll() method
set1.retainAll(set2);
// print set1
System.out.println("LinkedHashSet after "
+ "retainAll() operation : "
+ set1);
}
catch (NullPointerException e) {
System.out.println("Exception thrown : " + e);
}
}
}
Producción:
LinkedHashSet 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