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