CKTIS / C#
Array.Empty<T> — um array vazio de um tipo especificado
Array.Empty<T>() devolve um array não nulo do tipo T[] com comprimento zero. Utilize este método para representar a ausência de elementos sem criar um novo array vazio em cada chamada.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
Array.Empty<T>()Array.Empty<T> é um método estático de System.Array, disponível no .NET 10. A sua declaração é public static T[] Empty<T>();. O parâmetro de tipo T especifica o tipo dos elementos; por exemplo, Array.Empty<string>() devolve um array string[] vazio. O método não aceita argumentos.
O resultado não é null: o seu Length é 0 e um ciclo foreach não realiza nenhuma iteração. Assim, pode representar «nenhum elemento» sem verificar se o valor é null antes de iterar. No entanto, um array vazio não tem qualquer elemento no índice 0 — não leia nem escreva nesse índice.
Utilize Array.Empty<T>() em vez de new T[0] quando precisar de um array vazio. Para um dado T, o método utiliza uma instância vazia partilhada, evitando alocações repetidas de arrays vazios. Não o encare como uma forma de criar um objeto distinto em cada chamada; a regra do analisador CA1825 recomenda esta substituição.
O exemplo apresenta o comprimento do array e o resultado de uma verificação de null. O ciclo não apresenta nada. Esta é uma API da biblioteca .NET, não uma funcionalidade de sintaxe que exija LangVersion=preview.
Exemplos
using System;
internal static class Program
{
private static void Main()
{
string[] names = Array.Empty<string>();
Console.WriteLine(names.Length);
Console.WriteLine(names is null);
foreach (string name in names)
{
Console.WriteLine(name);
}
}
}Resultado
0 False
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.