...
Eroare Python · Erori de tip (TypeError)

TypeError: replace() argument 1 must be str, not int

Pe scurt

Ai dat un număr unei metode de text care așteaptă text, de exemplu `cod.replace(2024, 2025)`. Pune numerele între ghilimele sau convertește-le cu `str()`: `cod.replace("2024", "2025")`.

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

Ce înseamnă

Metodele de text (replace, split, startswith, endswith, count, find...) lucrează doar cu alte texte. Python nu transformă automat numărul 2024 în textul "2024", așa că oprește programul și îți spune ce argument e greșit: „argument 1” e primul, „argument 2” e al doilea.

Eroarea apare des când valorile vin din calcule (an + 1 e un int) sau din date numerice (un JSON cu "an": 2024), iar textul în care cauți e un str. La alte metode mesajul arată puțin diferit, dar cauza e aceeași: startswith first arg must be str or a tuple of str, not int, must be str or None, not int (la split), strptime() argument 1 must be str, not datetime.datetime (când dai o dată deja convertită lui strptime).

De ce apare: cauzele frecvente

1Numere în loc de text la replace

Greșit
PYTHON
cod = "RO-2024-001"
print(cod.replace(2024, 2025))
Corect
PYTHON
cod = "RO-2024-001"
print(cod.replace("2024", "2025"))

replace înlocuiește un text cu alt text. Ambele argumente trebuie să fie str.

2Valoare calculată

Greșit
PYTHON
an = 2024
cod = "RO-2024-001"
print(cod.replace(str(an), an + 1))
Corect
PYTHON
an = 2024
cod = "RO-2024-001"
print(cod.replace(str(an), str(an + 1)))

an + 1 e un număr. Aici mesajul e replace() argument 2 must be str, not int; str() îl transformă în text.

3startswith cu un număr

Greșit
PYTHON
telefon = "40722123456"
prefix = 40
print(telefon.startswith(prefix))
Corect
PYTHON
telefon = "40722123456"
prefix = 40
print(telefon.startswith(str(prefix)))

Prefixul trebuie să fie text. Aici mesajul e startswith first arg must be str or a tuple of str, not int.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos actualizează anul dintr-un cod de factură, dar dă TypeError: replace() argument 1 must be str, not int. Repară apelul, ca programul să afișeze RO-2025-001.

Codul care dă eroarea
PYTHON
cod = "RO-2024-001"
an_vechi = 2024
an_nou = an_vechi + 1
print(cod.replace(an_vechi, an_nou))
După reparație, programul afișează
RO-2025-001
Indiciu

Ambele argumente ale lui replace trebuie să fie text.

Alte forme ale mesajului

  • TypeError: replace() argument 2 must be str, not int
  • TypeError: startswith first arg must be str or a tuple of str, not int
  • TypeError: must be str or None, not int
  • TypeError: strptime() argument 1 must be str, not datetime.datetime

Cum o eviți pe viitor

  • Când combini numere cu texte, convertește explicit: str(numar) sau un f-string.
  • Ține minte că metodele de text nu fac conversii automate, spre deosebire de print.
  • Dacă lucrezi des cu coduri formate din numere (ani, numere de comandă), păstrează-le ca text de la început.

Întrebări frecvente

De ce print(2024) merge, dar replace(2024, ...) nu?

print transformă singur orice valoare în text pentru afișare. replace nu face conversii: caută exact textul primit, iar un număr nu e text.

Ce înseamnă „must be str or None”?

Apare la split: separatorul poate fi un text sau None (care înseamnă „orice spațiu”), dar nu un număr. Scrie text.split("1") dacă voiai să împarți după cifra 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.