CKTIS / C#
Array.Empty<T> — prázdné pole zadaného typu
Array.Empty<T>() vrací nenulové pole typu T[] s délkou nula. Použijte tuto metodu k vyjádření absence prvků, aniž by se při každém volání vytvářelo nové prázdné pole.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
Array.Empty<T>()Array.Empty<T> je statická metoda třídy System.Array, dostupná v .NET 10. Její deklarace je public static T[] Empty<T>();. Parametr typu T určuje typ prvků; například Array.Empty<string>() vrací prázdné pole string[]. Metoda nepřijímá žádné argumenty.
Výsledek není null: jeho Length je 0 a cyklus foreach neprovede žádnou iteraci. Můžete tak vyjádřit „žádné prvky“ bez kontroly na null před iterací. Prázdné pole však nemá na indexu 0 žádný prvek — tento index nečtěte ani do něj nezapisujte.
Pokud potřebujete prázdné pole, použijte Array.Empty<T>() místo new T[0]. Pro dané T metoda používá sdílenou prázdnou instanci, čímž zabraňuje opakovaným alokacím prázdných polí. Nepovažujte ji za způsob, jak při každém volání vytvořit samostatný objekt; pravidlo analyzátoru CA1825 toto nahrazení doporučuje.
Příklad vypíše délku pole a výsledek kontroly null. Cyklus nevypíše nic. Jde o API knihovny .NET, nikoli o syntaktickou funkci vyžadující LangVersion=preview.
Příklady
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);
}
}
}Výsledek
0 False
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.