...
Eroare Python · Liste, șiruri și dicționare

IndexError: string index out of range

Pe scurt

Ceri un caracter de pe o poziție care nu există în text: pozițiile merg de la 0 la `len(text) - 1`. Apare la texte goale (`text[0]` pe `""`) sau la bucle care depășesc lungimea. Verifică lungimea înainte sau folosește felii (`text[:1]`), care nu dau eroare.

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

Ce înseamnă

Un text se indexează ca o listă: "Ana"[0] e "A", "Ana"[2] e "a", iar "Ana"[3] nu există. Mesajul string index out of range înseamnă că pe linia din eroare ai cerut o poziție din afara textului.

Cel mai des textul e gol: un câmp necompletat, o linie goală dintr-un fișier, rezultatul unui strip() pe un text doar cu spații. Apoi text[0] (prima literă) eșuează. Alte cauze: o buclă care compară text[i] cu text[i + 1] până la final, sau un indice calculat greșit. Diferența importantă: feliile nu dau eroare. ""[0] dă IndexError, dar ""[:1] dă pur și simplu textul gol. La fel, text.startswith("A") e mai sigur decât text[0] == "A".

De ce apare: cauzele frecvente

1Prima literă a unui text gol

Greșit
PYTHON
nume = ""
initiala = nume[0]
Corect
PYTHON
nume = ""
initiala = nume[:1]

Felia [:1] dă primul caracter dacă există sau textul gol dacă nu, fără eroare.

2Inițialele dintr-un text cu spații duble

Greșit
PYTHON
nume = "Ana  Maria Pop"
print([p[0] for p in nume.split(" ")])
Corect
PYTHON
nume = "Ana  Maria Pop"
print([p[0] for p in nume.split()])

split(" ") lasă bucăți goale între două spații. split() fără argument le ignoră.

3Comparare cu caracterul următor

Greșit
PYTHON
s = "aabb"
for i in range(len(s)):
    if s[i] == s[i + 1]:
        print(i)
Corect
PYTHON
s = "aabb"
for i in range(len(s) - 1):
    if s[i] == s[i + 1]:
        print(i)

La ultimul caracter nu mai există unul următor, deci bucla se oprește cu un pas mai devreme.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos generează inițialele dintr-un nume, dar dă IndexError: string index out of range, pentru că numele are spații duble. Repară-l ca să afișeze A.M.P..

Codul care dă eroarea
PYTHON
nume = "Ana  Maria   Popescu"
initiale = ""
for parte in nume.split(" "):
    initiale += parte[0].upper() + "."
print(initiale)
După reparație, programul afișează
A.M.P.
Indiciu

split(" ") lasă bucăți goale între spațiile duble; split() fără argument nu.

Alte forme ale mesajului

  • IndexError: list index out of range
  • IndexError: tuple index out of range

Cum o eviți pe viitor

  • Verifică textele care pot fi goale (if text:) înainte să accesezi caractere.
  • Folosește split() fără argument pentru cuvinte, ca să eviți bucățile goale.
  • Preferă startswith, endswith și feliile în locul indicilor fixi.
  • La comparații între caractere vecine, oprește bucla la len(s) - 1.

Întrebări frecvente

De ce felia nu dă eroare, dar indicele da?

Un indice cere un element anume, care fie există, fie nu. O felie cere o porțiune, iar Python o taie pur și simplu la marginile textului: dacă porțiunea e în afara textului, rezultatul e gol.

Cum iau ultimul caracter?

Cu text[-1]. Pentru un text gol, și asta dă IndexError; varianta sigură este text[-1:].

Erori înrudite

← Toate erorile Python

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ță Python de la zero, cu exerciții la fiecare lecție

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