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.