El método toArray(T[]) de la clase HashSet en Java se utiliza para formar una array de los mismos elementos que la de HashSet. Devuelve una array que contiene todos los elementos de este HashSet en el orden correcto; el tipo de tiempo de ejecución de la array devuelta es el de la array especificada. Si el HashSet encaja en la array especificada, se devuelve allí. De lo contrario, se asigna una nueva array con el tipo de tiempo de ejecución de la array especificada y el tamaño de este HashSet.
Si HashSet cabe en la array especificada con espacio de sobra (es decir, la array tiene más elementos que HashSet), el elemento de la array que sigue inmediatamente al final de HashSet se establece en nulo. (Esto es útil para determinar la longitud del HashSet solo si la persona que llama sabe que el HashSet no contiene ningún elemento nulo).
Sintaxis:
public <T> T[] toArray(T[] a)
Parámetros: el método acepta un parámetro arr[] que es la array en la que se almacenarán los elementos del HashSet, si es lo suficientemente grande; de lo contrario, se asigna una nueva array del mismo tipo de tiempo de ejecución para este propósito.
Valor devuelto: el método devuelve una array que contiene los elementos similares al HashSet.
Excepción: el método puede generar dos tipos de excepción:
- ArrayStoreException : cuando la array mencionada es de un tipo diferente y no se puede comparar con los elementos mencionados en el HashSet.
- NullPointerException : si la array es nula, se lanza esta excepción.
El siguiente programa ilustra el funcionamiento del método HashSet.toArray(arr[]).
Programa 1: cuando la array es del tamaño de HashSet
// Java code to illustrate toArray(arr[]) import java.util.*; public class HashSetDemo { public static void main(String args[]) { // Creating an empty HashSet HashSet<String> hashSet = new HashSet<String>(); // Use add() method to add // elements into the HashSet hashSet.add("Welcome"); hashSet.add("To"); hashSet.add("Geeks"); hashSet.add("For"); hashSet.add("Geeks"); // Displaying the HashSet System.out.println("The HashSet: " + hashSet); // Creating the array and using toArray() String[] arr = new String[5]; arr = hashSet.toArray(arr); // Displaying arr System.out.println("The arr[] is:"); for (int j = 0; j < arr.length; j++) System.out.println(arr[j]); } }
The HashSet: [Geeks, For, Welcome, To] The arr[] is: Geeks For Welcome To null
Programa 2: cuando la array es menor que el tamaño de HashSet
// Java code to illustrate toArray(arr[]) import java.util.*; public class HashSetDemo { public static void main(String args[]) { // Creating an empty HashSet HashSet<String> hashSet = new HashSet<String>(); // Use add() method to add // elements into the HashSet hashSet.add("Welcome"); hashSet.add("To"); hashSet.add("Geeks"); hashSet.add("For"); hashSet.add("Geeks"); // Displaying the HashSet System.out.println("The HashSet: " + hashSet); // Creating the array and using toArray() String[] arr = new String[1]; arr = hashSet.toArray(arr); // Displaying arr System.out.println("The arr[] is:"); for (int j = 0; j < arr.length; j++) System.out.println(arr[j]); } }
The HashSet: [Geeks, For, Welcome, To] The arr[] is: Geeks For Welcome To
Programa 3: cuando la array es mayor que el tamaño de HashSet
// Java code to illustrate toArray(arr[]) import java.util.*; public class HashSetDemo { public static void main(String args[]) { // Creating an empty HashSet HashSet<String> hashSet = new HashSet<String>(); // Use add() method to add // elements into the HashSet hashSet.add("Welcome"); hashSet.add("To"); hashSet.add("Geeks"); hashSet.add("For"); hashSet.add("Geeks"); // Displaying the HashSet System.out.println("The HashSet: " + hashSet); // Creating the array and using toArray() String[] arr = new String[10]; arr = hashSet.toArray(arr); // Displaying arr System.out.println("The arr[] is:"); for (int j = 0; j < arr.length; j++) System.out.println(arr[j]); } }
The HashSet: [Geeks, For, Welcome, To] The arr[] is: Geeks For Welcome To null null null null null null
Programa 4: Para demostrar NullPointerException
// Java code to illustrate toArray(arr[]) import java.util.*; public class HashSetDemo { public static void main(String args[]) { // Creating an empty HashSet HashSet<String> hashSet = new HashSet<String>(); // Use add() method to add // elements into the HashSet hashSet.add("Welcome"); hashSet.add("To"); hashSet.add("Geeks"); hashSet.add("For"); hashSet.add("Geeks"); // Displaying the HashSet System.out.println("The HashSet: " + hashSet); try { // Creating the array String[] arr = null; // using toArray() // Since arr is null // Hence exception will be thrown arr = hashSet.toArray(arr); // Displaying arr System.out.println("The arr[] is:"); for (int j = 0; j < arr.length; j++) System.out.println(arr[j]); } catch (Exception e) { System.out.println("Exception: " + e); } } }
The HashSet: [Geeks, For, Welcome, To] Exception: java.lang.NullPointerException