CKTIS / C#
Array.Empty<T> — prazno polje določene vrste
Array.Empty<T>() vrne polje tipa T[] z dolžino nič, ki ni null. Uporabi to metodo za predstavitev odsotnosti elementov, ne da bi ob vsakem klicu ustvaril novo prazno polje.
Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
Array.Empty<T>()Array.Empty<T> je statična metoda razreda System.Array, na voljo v .NET 10. Njena deklaracija je public static T[] Empty<T>();. Tipski parameter T določa vrsto elementov; na primer, Array.Empty<string>() vrne prazno polje string[]. Metoda ne sprejema argumentov.
Rezultat ni null: njegova Length je 0, zanka foreach pa ne izvede nobene ponovitve. Tako lahko predstaviš »brez elementov«, ne da bi pred iteracijo preverjal, ali je vrednost null. Prazno polje pa nima elementa na indeksu 0 — tega indeksa ne beri in vanj ne zapisuj.
Ko potrebuješ prazno polje, uporabi Array.Empty<T>() namesto new T[0]. Za določen T metoda uporablja skupni prazni primerek in se tako izogne ponavljajočim se dodelitvam praznih polj. Ne obravnavaj je kot načina za ustvarjanje ločenega objekta ob vsakem klicu; pravilo analizatorja CA1825 priporoča to zamenjavo.
Primer izpiše dolžino polja in rezultat preverjanja null. Zanka ne izpiše ničesar. To je API knjižnice .NET, ne sintaktična funkcija, za katero bi bil potreben LangVersion=preview.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.