...
Eroare Swift · Erori fatale la rulare

Fatal error: Index out of range

Pe scurt

Ai accesat un element de tablou cu un indice care nu există: negativ sau mai mare ori egal cu count (de exemplu lista[3] într-o listă cu 3 elemente). Indicii merg de la 0 la count - 1; verifică indicele sau folosește indices, first, last.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un tablou cu n elemente are indicii 0, 1, ..., n - 1. Când accesezi lista[i] cu un i în afara acestui interval, Swift nu întoarce o valoare oarecare, ci oprește programul cu Fatal error: Index out of range. În Xcode vezi Thread 1: Fatal error: Index out of range pe linia cu accesul; în consolă, mesajul începe cu fișierul bibliotecii standard (Swift/ContiguousArrayBuffer.swift:...), dar locul greșelii e în codul tău, la accesul cu [ ].

Cauzele clasice: bucla for i in 0...lista.count (cu ... în loc de ..<), lista[lista.count] pentru ultimul element, acces într-o listă goală (lista[0]), un indice calculat greșit (i + 1 la ultimul pas) sau o listă din care ai șters elemente în timp ce o parcurgeai cu indici.

Spre deosebire de dicționare, tablourile nu întorc opționale la acces: e responsabilitatea ta să folosești indici valizi.

De ce apare: cauzele frecvente

1Bucla merge cu un pas prea departe

Greșit
SWIFT
let note = [7, 9, 10]
for i in 0...note.count {
    print(note[i])
}
Corect
SWIFT
let note = [7, 9, 10]
for i in 0..<note.count {
    print(note[i])
}

0...3 include și 3, dar ultimul indice valid e 2. ..< exclude capătul; și mai sigur: for i in note.indices sau for n in note.

2Ultimul element luat cu count

Greșit
SWIFT
let orase = ["Cluj", "Iași", "Timișoara"]
print(orase[orase.count])
Corect
SWIFT
let orase = ["Cluj", "Iași", "Timișoara"]
print(orase[orase.count - 1])

Ultimul indice este count - 1. Și mai bine: orase.last, care întoarce nil pentru o listă goală.

3Comparare cu elementul următor

Greșit
SWIFT
let t = [3, 5, 4]
for i in 0..<t.count {
    if t[i + 1] > t[i] { print("crește la \(i + 1)") }
}
Corect
SWIFT
let t = [3, 5, 4]
for i in 0..<(t.count - 1) {
    if t[i + 1] > t[i] { print("crește la \(i + 1)") }
}

La ultimul pas i + 1 iese din tablou. Bucla trebuie să se oprească cu un pas mai devreme.

Repară tu

Repară eroarea, direct în pagină

Programul afișează clasamentul unui concurs, cu locul și numele: 1. Ana, 2. Mihai, 3. Ioana, fiecare pe un rând. În loc de asta, după cele trei rânduri se oprește cu Fatal error: Index out of range. Repară intervalul buclei.

Codul care dă eroarea
SWIFT
let clasament = ["Ana", "Mihai", "Ioana"]
for i in 0...clasament.count {
    print("\(i + 1). \(clasament[i])")
}
După reparație, programul afișează
1. Ana
2. Mihai
3. Ioana
Indiciu

Cu 3 elemente, indicii valizi sunt 0, 1 și 2.

Alte forme ale mesajului

  • Thread 1: Fatal error: Index out of range
  • Fatal error: Array index is out of range
  • Fatal error: String index is out of bounds

Cum o eviți pe viitor

  • Parcurge colecțiile direct (for x in lista) sau cu enumerated() / indices, nu cu intervale scrise de mână.
  • Folosește ..< cu count, niciodată ....
  • Pentru primul și ultimul element, folosește first și last, care sunt opționale și nu opresc programul.
  • Verifică lista.indices.contains(i) înainte de un acces cu un indice venit din calcule sau de la utilizator.

Întrebări frecvente

De ce Swift nu întoarce nil, ca la dicționare?

Pentru că accesul la tablou e foarte frecvent și foarte rapid; un opțional la fiecare acces ar complica tot codul. Swift preferă să oprească imediat programul la un indice greșit decât să continue cu memorie greșită.

Pot face un acces sigur care întoarce opțional?

Da, cu o extensie: extension Array { subscript(sigur i: Int) -> Element? { indices.contains(i) ? self[i] : nil } }, apoi lista[sigur: 5].

Erori înrudite

← Toate erorile Swift

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Swift de la zero, cu exerciții la fiecare lecție

Curs Swift (iOS): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.