Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori