Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Converter um fluxo num array tipado com Stream.toArray(IntFunction)

Reúne os elementos de um fluxo num array do tipo escolhido, como `String[]`, passando uma função que cria um array com o comprimento pedido.

Versão: Java SE 21

Sintaxe

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

Em Java SE 21, Stream.toArray(IntFunction), da interface java.util.stream.Stream<T>, reúne os elementos produzidos pela sequência de operações num array A[]. É uma operação terminal: depois de a executar, não podes reutilizar o mesmo fluxo. Se o fluxo tiver uma ordem de iteração definida, o array conserva-a.

O gerador java.util.function.IntFunction<A[]> recebe o comprimento como um int e devolve um novo array com esse comprimento. Aqui, String[]::new é equivalente a length -> new String[length]. O fluxo fornece o tamanho; não assumas que chama o gerador apenas uma vez. Poderá precisar de arrays adicionais quando divide o processamento em partes ou redimensiona um array.

Sem argumentos, toArray() devolve um Object[] cujo tipo de componente em tempo de execução é Object, mesmo para um Stream<String>. Na sobrecarga com gerador, A é o tipo de componente do array, independente do tipo T dos elementos do fluxo. O método não converte os elementos: lança ArrayStoreException se o tipo de componente em tempo de execução impedir que algum elemento seja guardado no array.

Exemplos

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` exclui `Bo` porque o nome tem menos de 3 caracteres. `String[]::new` permite atribuir o resultado a `String[]` sem conversão explícita de tipo, e `Arrays.toString` apresenta `[Ada, Clara]`.

Lições relacionadas

  • Java · Lição 63 · Básico · Versão: 2

Fontes