KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

Array.Length — aantal array-elementen

Array.Length retourneert het aantal elementen in een array als int. Bij een multidimensionale array omvat dit alle dimensies; bij een lege array is de waarde 0.

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

Syntax

public int Length { get; }

array.Length

Array.Length is een alleen-lezen eigenschap: gebruik array.Length, zonder aanroep-haakjes. Het uitlezen heeft complexiteit O(1).

De lengte is het aantal elementplaatsen, niet het aantal waarden die niet nul zijn. Een array heeft een vaste grootte: new int[3] heeft lengte 3, ook al bevat deze aanvankelijk alleen nullen.

Voor new int[2, 3] is Length gelijk aan 6. Verwar dit niet met Rank, het aantal dimensies. GetLength(0) en GetLength(1) retourneren de grootte van de afzonderlijke dimensies: 2 en 3.

Als een multidimensionale array meer dan Int32.MaxValue elementen bevat, veroorzaakt het uitlezen van Length een OverflowException. LongLength geeft het totale aantal elementen als een 64-bits geheel getal.

Voorbeelden

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

Resultaat

3
6
2
3
0

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen