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