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

IndexError: Replacement index 1 out of range for positional args tuple

Pe scurt

Șablonul dat lui `.format()` are mai multe locuri `{}` decât argumente primite. Dă câte un argument pentru fiecare `{}`, iar dacă valorile sunt într-o listă, despachetează-le: `sablon.format(*valori)`.

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

Ce înseamnă

str.format() înlocuiește fiecare {} (sau {0}, {1}...) cu argumentul de pe poziția corespunzătoare. Argumentele poziționale stau într-un tuplu, iar „replacement index 1” înseamnă că șablonul a cerut argumentul cu numărul 1 (al doilea), dar tuplul are mai puține elemente.

Cauzele obișnuite: ai adăugat un {} în text și ai uitat să adaugi valoarea, ai dat o listă ca un singur argument (format(["Ana", 120]) e un singur argument, lista întreagă), sau ai numerotat greșit locurile ({0}, {2} cu doar două argumente). La câmpurile cu nume ({client}) problema similară dă KeyError: 'client'. Pe Python mai vechi de 3.8, mesajul era IndexError: tuple index out of range.

De ce apare: cauzele frecvente

1Argument uitat

Greșit
PYTHON
print("Client: {}, total: {} lei".format("Ana"))
Corect
PYTHON
print("Client: {}, total: {} lei".format("Ana", 120))

Două locuri au nevoie de două argumente.

2Listă dată ca un singur argument

Greșit
PYTHON
valori = ["Ana", 120]
print("Client: {}, total: {} lei".format(valori))
Corect
PYTHON
valori = ["Ana", 120]
print("Client: {}, total: {} lei".format(*valori))

*valori desface lista în argumente separate: "Ana" și 120.

3Numerotare greșită

Greșit
PYTHON
print("{0} a plătit {2} lei".format("Ana", 120))
Corect
PYTHON
print("{0} a plătit {1} lei".format("Ana", 120))

Numerotarea începe de la 0, deci al doilea argument e {1}.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos afișează un rezumat de comandă cu valorile dintr-o listă, dar dă IndexError: Replacement index 1 out of range for positional args tuple. Repară apelul lui format, ca programul să afișeze Client: Ana, total: 120 lei.

Codul care dă eroarea
PYTHON
comanda = ["Ana", 120]
print("Client: {}, total: {} lei".format(comanda))
După reparație, programul afișează
Client: Ana, total: 120 lei
Indiciu

Lista trebuie desfăcută în argumente separate.

Alte forme ale mesajului

  • IndexError: Replacement index 2 out of range for positional args tuple
  • IndexError: tuple index out of range

Cum o eviți pe viitor

  • Folosește f-string-uri: f"Client: {nume}, total: {total} lei"; valorile stau chiar în text, deci nu pot lipsi.
  • Dacă folosești format, preferă câmpuri cu nume: "{client}".format(client="Ana").
  • Când valorile sunt într-o listă sau un dicționar, folosește *lista sau **dictionar.
  • Numără locurile {} și argumentele când modifici un șablon.

Întrebări frecvente

Ce se întâmplă dacă dau mai multe argumente decât locuri?

Nimic: argumentele în plus sunt ignorate fără eroare. Doar lipsa lor e o problemă.

Pot amesteca {} cu {0}?

Nu. Python refuză amestecul cu ValueError: cannot switch from automatic field numbering to manual field specification. Alege o singură variantă în același șablon.

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.