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

CKTIS / C#

Array.Length — počet prvků pole

Array.Length vrací počet prvků pole jako int. U vícerozměrného pole zahrnuje všechny rozměry; u prázdného pole je jeho hodnota 0.

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

Syntaxe

public int Length { get; }

array.Length

Array.Length je vlastnost pouze pro čtení: použijte array.Length bez závorek pro volání. Její čtení má složitost O(1).

Délka znamená počet míst pro prvky, nikoli počet nenulových hodnot. Pole má pevnou velikost: new int[3] má délku 3, přestože zpočátku obsahuje pouze nuly.

Pro new int[2, 3] má Length hodnotu 6. Nezaměňujte ji za Rank, tedy počet rozměrů. GetLength(0) a GetLength(1) vracejí velikosti jednotlivých rozměrů: 2 a 3.

Pokud vícerozměrné pole obsahuje více než Int32.MaxValue prvků, čtení Length vyvolá OverflowException. LongLength zpřístupňuje celkový počet prvků jako 64bitové celé číslo.

Příklady

using System;

int[] values = new int[3];
int[,] grid = new int[2, 3];

Console.WriteLine(values.Length);
Console.WriteLine(grid.Length);
Console.WriteLine(grid.GetLength(0));
Console.WriteLine(grid.GetLength(1));
Console.WriteLine(new int[0].Length);

Výsledek

3
6
2
3
0

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