Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

Array.Empty<T> — prázdne pole zadaného typu

Array.Empty<T>() vracia nenulové pole typu T[] s dĺžkou nula. Použite túto metódu na vyjadrenie neprítomnosti prvkov bez vytvárania nového prázdneho poľa pri každom volaní.

Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

Array.Empty<T>()

Array.Empty<T> je statická metóda triedy System.Array, dostupná v .NET 10. Jej deklarácia je public static T[] Empty<T>();. Parameter typu T určuje typ prvkov; napríklad Array.Empty<string>() vracia prázdne pole string[]. Metóda neprijíma žiadne argumenty.

Výsledok nie je null: jeho Length je 0 a cyklus foreach nevykoná žiadnu iteráciu. Môžete tak vyjadriť „žiadne prvky“ bez kontroly na null pred iteráciou. Prázdne pole však nemá na indexe 0 žiadny prvok — tento index nečítajte ani doň nezapisujte.

Ak potrebujete prázdne pole, použite Array.Empty<T>() namiesto new T[0]. Pre dané T metóda používa zdieľanú prázdnu inštanciu, čím predchádza opakovaným alokáciám prázdnych polí. Nepovažujte ju za spôsob, ako pri každom volaní vytvoriť samostatný objekt; pravidlo analyzátora CA1825 odporúča túto náhradu.

Príklad vypíše dĺžku poľa a výsledok kontroly null. Cyklus nevypíše nič. Ide o API knižnice .NET, nie o syntaktickú funkciu vyžadujúcu LangVersion=preview.

Prí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ýsledok

0
False

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje