CKTIS / C#
IndexOutOfRangeException — indeks izvan granica
System.IndexOutOfRangeException, među ostalim, označava pokušaj čitanja ili zapisivanja elementa polja s nevažećim indeksom. U pravilu ispravite izračun indeksa ili granice petlje umjesto da iznimku koristite za uobičajeni tijek programa.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
array[index]
catch (System.IndexOutOfRangeException ex) { /* diagnostic handling */ }System.IndexOutOfRangeException iznimka je koja se, među ostalim, izbacuje pri čitanju ili zapisivanju elementa polja izvan njegovih granica. Obično upućuje na pogrešku u kodu čiji uzrok treba utvrditi i ispraviti, a ne prikriti hvatanjem iznimke.
Za jednodimenzionalno polje int[] indeks je valjan ako zadovoljava uvjet 0 <= index && index < values.Length. Length označava broj elemenata, a ne posljednji indeks. Prazno polje nema nijedan valjan indeks. U petlji upotrijebite i < values.Length, a ne i <= values.Length; ako su vam potrebne samo vrijednosti, odaberite foreach.
Ne izbacuje svaki indeksator istu iznimku. Za indeks manji od 0 ili veći ili jednak Count, List<T> izbacuje ArgumentOutOfRangeException, a ne IndexOutOfRangeException. Vrsta iznimke ovisi o upotrijebljenom API-ju, iako je sintaksa [] slična.
Primjer namjerno čita values[values.Length] i hvata iznimku isključivo radi demonstracije. Nakon toga ispravna petlja ispisuje sve elemente. U stvarnom kodu ispravite granice ili provjerite indeks prije pristupa; nemojte tretirati catch kao uobičajeni uvjet za završetak petlje.
Primjeri
using System;
internal static class Program
{
private static void Main()
{
int[] values = { 10, 20, 30 };
int index = values.Length;
try
{
Console.WriteLine(values[index]);
}
catch (IndexOutOfRangeException ex)
{
Console.WriteLine(ex.GetType().Name);
}
for (int i = 0; i < values.Length; i++)
{
Console.WriteLine(values[i]);
}
}
}Rezultat
IndexOutOfRangeException 10 20 30
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.