Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje