Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

Array.Empty<T> — prazno polje određenog tipa

Array.Empty<T>() vraća niz vrste T[] koji nije null i ima duljinu nula. Upotrijebi ovu metodu za prikaz odsutnosti elemenata bez stvaranja novog praznog niza pri svakom pozivu.

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

Sintaksa

Array.Empty<T>()

Array.Empty<T> statička je metoda klase System.Array, dostupna u .NET 10. Njezina je deklaracija public static T[] Empty<T>();. Parametar vrste T određuje vrstu elemenata; primjerice, Array.Empty<string>() vraća prazan niz string[]. Metoda ne prima argumente.

Rezultat nije null: njegov je Length 0, a petlja foreach ne izvršava nijednu iteraciju. Tako možeš prikazati „nema elemenata” bez provjere je li vrijednost null prije iteracije. Međutim, prazan niz nema element na indeksu 0 — nemoj čitati ni zapisivati na taj indeks.

Kada ti treba prazan niz, upotrijebi Array.Empty<T>() umjesto new T[0]. Za određeni T metoda upotrebljava zajedničku praznu instancu i tako izbjegava ponovljene alokacije praznih nizova. Nemoj je smatrati načinom stvaranja zasebnog objekta pri svakom pozivu; pravilo analizatora CA1825 preporučuje ovu zamjenu.

Primjer ispisuje duljinu niza i rezultat provjere null. Petlja ne ispisuje ništa. Ovo je API biblioteke .NET, a ne značajka sintakse koja zahtijeva LangVersion=preview.

Primjeri

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);
        }
    }
}

Rezultat

0
False

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori