Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Convertir un flujo en un array tipado con Stream.toArray(IntFunction)

Reúne los elementos de un flujo en un array del tipo que elijas, como `String[]`, pasando una función que crea un array de la longitud solicitada.

Versión: Java SE 21

Sintaxis

<A> A[] toArray(java.util.function.IntFunction<A[]> generator)

En Java SE 21, Stream.toArray(IntFunction), de java.util.stream.Stream<T>, reúne en un array A[] los elementos que produce la cadena de operaciones. Es una operación terminal: después no puedes volver a usar el mismo flujo. Si el flujo tiene un orden de recorrido definido, el array lo conserva.

El generador java.util.function.IntFunction<A[]> recibe la longitud como un int y devuelve un array nuevo de esa longitud. Aquí, String[]::new equivale a length -> new String[length]. El flujo proporciona el tamaño; no supongas que llama al generador una sola vez. Puede necesitar arrays adicionales al dividir el procesamiento en partes o al cambiar el tamaño.

La variante toArray() sin argumentos devuelve un Object[] cuyo tipo de componente en tiempo de ejecución es Object, incluso para un Stream<String>. En la sobrecarga con generador, A es el tipo de componente del array, independiente del tipo T de los elementos del flujo. El método no convierte los elementos: lanza ArrayStoreException si el tipo de componente en tiempo de ejecución impide guardar algún elemento.

Ejemplos

import java.util.Arrays;
import java.util.stream.Stream;

public class StreamToArrayExample {
    public static void main(String[] args) {
        String[] names = Stream.of("Ada", "Bo", "Clara")
                .filter(name -> name.length() >= 3)
                .toArray(String[]::new);

        System.out.println(Arrays.toString(names));
    }
}

Resultado

[Ada, Clara]

`filter` excluye `Bo` porque el nombre tiene menos de 3 caracteres. `String[]::new` permite asignar el resultado a `String[]` sin conversión explícita de tipo, y `Arrays.toString` muestra `[Ada, Clara]`.

Lecciones relacionadas

  • Java · Lección 63 · Básico · Versión: 2

Fuentes