El método toArray(T[]) de la clase AbstractSet en Java se utiliza para formar una array de los mismos elementos que la de AbstractSet. Devuelve una array que contiene todos los elementos de este AbstractSet en el orden correcto; el tipo de tiempo de ejecución de la array devuelta es el de la array especificada. Si el AbstractSet 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 AbstractSet.
Si AbstractSet cabe en la array especificada con espacio de sobra (es decir, la array tiene más elementos que AbstractSet), el elemento de la array que sigue inmediatamente al final de AbstractSet se establece en nulo. (Esto es útil para determinar la longitud de AbstractSet solo si la persona que llama sabe que AbstractSet 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 AbstractSet, 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 a AbstractSet.
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 AbstractSet.
- NullPointerException : si la array es nula, se lanza esta excepción.
El siguiente programa ilustra el funcionamiento del método AbstractSet.toArray(arr[]).
Programa 1: cuando la array es del tamaño de AbstractSet
// Java code to illustrate toArray(arr[])
import java.util.*;
public class AbstractSetDemo {
public static void main(String args[])
{
// Creating an empty AbstractSet
AbstractSet<String>
abs_col = new TreeSet<String>();
// Use add() method to add
// elements into the AbstractSet
abs_col.add("Welcome");
abs_col.add("To");
abs_col.add("Geeks");
abs_col.add("For");
abs_col.add("Geeks");
// Displaying the AbstractSet
System.out.println("The AbstractSet: "
+ abs_col);
// Creating the array and using toArray()
String[] arr = new String[5];
arr = abs_col.toArray(arr);
// Displaying arr
System.out.println("The arr[] is:");
for (int j = 0; j < arr.length; j++)
System.out.println(arr[j]);
}
}
The AbstractSet: [For, Geeks, To, Welcome] The arr[] is: For Geeks To Welcome null
Programa 2: cuando la array es menor que el tamaño de AbstractSet
// Java code to illustrate toArray(arr[])
import java.util.*;
public class AbstractSetDemo {
public static void main(String args[])
{
// Creating an empty AbstractSet
AbstractSet<String>
abs_col = new TreeSet<String>();
// Use add() method to add
// elements into the AbstractSet
abs_col.add("Welcome");
abs_col.add("To");
abs_col.add("Geeks");
abs_col.add("For");
abs_col.add("Geeks");
// Displaying the AbstractSet
System.out.println("The AbstractSet: "
+ abs_col);
// Creating the array and using toArray()
String[] arr = new String[1];
arr = abs_col.toArray(arr);
// Displaying arr
System.out.println("The arr[] is:");
for (int j = 0; j < arr.length; j++)
System.out.println(arr[j]);
}
}
The AbstractSet: [For, Geeks, To, Welcome] The arr[] is: For Geeks To Welcome
Programa 3: cuando la array es mayor que el tamaño de AbstractSet
// Java code to illustrate toArray(arr[])
import java.util.*;
public class AbstractSetDemo {
public static void main(String args[])
{
// Creating an empty AbstractSet
AbstractSet<String>
abs_col = new TreeSet<String>();
// Use add() method to add
// elements into the AbstractSet
abs_col.add("Welcome");
abs_col.add("To");
abs_col.add("Geeks");
abs_col.add("For");
abs_col.add("Geeks");
// Displaying the AbstractSet
System.out.println("The AbstractSet: "
+ abs_col);
// Creating the array and using toArray()
String[] arr = new String[10];
arr = abs_col.toArray(arr);
// Displaying arr
System.out.println("The arr[] is:");
for (int j = 0; j < arr.length; j++)
System.out.println(arr[j]);
}
}
The AbstractSet: [For, Geeks, To, Welcome] The arr[] is: For Geeks To Welcome null null null null null null
Programa 4: Para demostrar NullPointerException
// Java code to illustrate toArray(arr[])
import java.util.*;
public class AbstractSetDemo {
public static void main(String args[])
{
// Creating an empty AbstractSet
AbstractSet<String>
abs_col = new TreeSet<String>();
// Use add() method to add
// elements into the AbstractSet
abs_col.add("Welcome");
abs_col.add("To");
abs_col.add("Geeks");
abs_col.add("For");
abs_col.add("Geeks");
// Displaying the AbstractSet
System.out.println("The AbstractSet: "
+ abs_col);
try {
// Creating the array
String[] arr = null;
// using toArray()
// Since arr is null
// Hence exception will be thrown
arr = abs_col.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 AbstractSet: [For, Geeks, To, Welcome] Exception: java.lang.NullPointerException