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

ValueError: substring not found

Pe scurt

Ai căutat într-un text cu `str.index()` (sau `rindex()`) o bucată care nu există în el. Folosește `str.find()`, care întoarce -1 în loc de eroare, sau verifică întâi cu `if bucata in text:`.

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

Ce înseamnă

text.index(sub) întoarce poziția primei apariții a lui sub în text. Dacă sub nu apare deloc, ridică ValueError: substring not found. Metoda soră text.find(sub) face același lucru, dar întoarce -1 când nu găsește, fără eroare.

De ce lipsește bucata? Literele mari/mici contează ("Total" vs "total"), separatorul e altul decât credeai (";" în loc de ",", " - " în loc de "-"), textul conține diacritice diferite (litera ș cu virgulă vs varianta veche, cu sedilă) sau procesezi un rând care chiar nu are bucata, de exemplu un antet sau un rând gol dintr-un fișier.

De ce apare: cauzele frecvente

1Rând fără separatorul căutat

Greșit
PYTHON
rand = "Ana Popescu"
poz = rand.index("@")
Corect
PYTHON
rand = "Ana Popescu"
poz = rand.find("@")
if poz == -1:
    print("Fără email")

find întoarce -1 când nu găsește, iar tu poți trata cazul.

2Litere mari diferite

Greșit
PYTHON
mesaj = "Total: 120 lei"
poz = mesaj.index("total")
Corect
PYTHON
mesaj = "Total: 120 lei"
poz = mesaj.lower().index("total")

Căutarea ține cont de litere mari. Adu ambele texte la aceeași formă.

3Folosești index doar ca să verifici existența

Greșit
PYTHON
email = "ana.exemplu.ro"
if email.index("@") >= 0:
    print("valid")
Corect
PYTHON
email = "ana.exemplu.ro"
if "@" in email:
    print("valid")

Pentru „există sau nu”, operatorul in e mai simplu și nu dă eroare.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos extrage domeniul din fiecare adresă de email și dă ValueError: substring not found, pentru că o adresă nu are @. Folosește find și afișează invalid pentru adresele fără @, ca programul să afișeze exemplu.ro, invalid și firma.com.

Codul care dă eroarea
PYTHON
emailuri = ["ana@exemplu.ro", "ion.exemplu.ro", "maria@firma.com"]
for e in emailuri:
    poz = e.index("@")
    print(e[poz + 1:])
După reparație, programul afișează
exemplu.ro
invalid
firma.com
Indiciu

find întoarce -1 când nu găsește bucata căutată.

Alte forme ale mesajului

  • ValueError: subsection not found

Cum o eviți pe viitor

  • Folosește in pentru verificări și find când ai nevoie de poziție și bucata poate lipsi.
  • Pentru a împărți un text după un separator, partition("@") nu dă eroare niciodată: întoarce (text, "", "") dacă separatorul lipsește.
  • Normalizează textul (lower(), strip()) înainte de căutare.
  • Pentru tipare complexe, folosește re.search, care întoarce None când nu găsește.

Întrebări frecvente

Când e mai bun index decât find?

Când bucata trebuie neapărat să existe și vrei ca programul să se oprească dacă lipsește. Așa nu folosești din greșeală -1 ca poziție, care la feliere ar însemna ultimul caracter.

Ce înseamnă „subsection not found”?

Este varianta aceleiași erori pentru bytes și bytearray: b"abc".index(b"z"). Cauza și reparația sunt aceleași.

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.