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

TypeError: string argument without an encoding

Pe scurt

Ai apelat bytes("text") sau bytearray("text") fără să spui cum se transformă textul în octeți. Adaugă codificarea: bytes("text", "utf-8") sau, mai simplu, "text".encode("utf-8").

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

Ce înseamnă

În Python 3, textul (str) și octeții (bytes) sunt tipuri diferite. Un text e o înșiruire de caractere (inclusiv ș, ț, emoji), iar octeții sunt numere de la 0 la 255. Ca să treci de la unul la altul ai nevoie de o codificare (encoding), de obicei utf-8, care spune cum se scrie fiecare caracter în octeți.

Când scrii bytes("parola"), Python nu știe ce codificare să folosească și refuză să ghicească: string argument without an encoding înseamnă exact asta, „mi-ai dat un text, dar nu mi-ai spus encoding-ul”.

Eroarea apare des când lucrezi cu hash-uri, criptare, socket-uri, fișiere binare sau API-uri care cer bytes. Linia din traceback arată apelul bytes(...) sau bytearray(...); argumentul de acolo e un str.

De ce apare: cauzele frecvente

1bytes() pe un text, fără encoding

Greșit
PYTHON
date = bytes("parolă")
print(len(date))
Corect
PYTHON
date = bytes("parolă", "utf-8")
print(len(date))

Cu al doilea argument, Python știe cum să transforme fiecare caracter în octeți (ă ocupă 2 octeți în UTF-8).

2bytearray() pe un text

Greșit
PYTHON
buffer = bytearray("salut")
buffer[0] = 83
print(buffer)
Corect
PYTHON
buffer = bytearray("salut", "utf-8")
buffer[0] = 83
print(buffer)

bytearray are aceeași regulă ca bytes: din text se poate crea doar dacă îi spui codificarea.

3Ai vrut de fapt metoda encode()

Greșit
PYTHON
mesaj = "Bună ziua"
octeti = bytes(mesaj)
print(octeti)
Corect
PYTHON
mesaj = "Bună ziua"
octeti = mesaj.encode("utf-8")
print(octeti)

text.encode("utf-8") e forma obișnuită în Python 3 și se citește mai ușor decât bytes(text, "utf-8").

Repară tu

Repară eroarea, direct în pagină

Programul transformă un mesaj în octeți ca să afle câți octeți ocupă în UTF-8, dar linia cu bytes(...) dă TypeError: string argument without an encoding. Repară-l ca să afișeze Caractere: 9 și Octeti: 12.

Codul care dă eroarea
PYTHON
mesaj = "Bună ziță"
octeti = bytes(mesaj)
print("Caractere:", len(mesaj))
print("Octeti:", len(octeti))
După reparație, programul afișează
Caractere: 9
Octeti: 12
Indiciu

Funcția bytes are nevoie și de numele codificării când primește un text.

Alte forme ale mesajului

  • TypeError: encoding without a string argument

Cum o eviți pe viitor

  • Ține minte regula: din str în bytes treci cu .encode("utf-8"), din bytes în str cu .decode("utf-8").
  • Scrie mereu codificarea explicit, chiar dacă utf-8 e implicit la encode(): codul e mai clar.
  • Când o funcție cere bytes (hash, socket, fișier deschis cu "wb"), transformă textul chiar înainte de apel.
  • Nu folosi bytes(n) cu un număr dacă vrei cifrele lui: bytes(3) creează 3 octeți nuli, nu textul "3".

Întrebări frecvente

Ce encoding să aleg?

Aproape mereu utf-8: suportă diacriticele românești și orice alt caracter, și e standardul pe web, în JSON și în majoritatea fișierelor. ascii dă eroare la ș, ț, ă.

Ce înseamnă varianta encoding without a string argument?

Inversul: ai dat o codificare, dar primul argument nu e text, de exemplu bytes(5, "utf-8") sau bytes([1, 2], "utf-8"). Codificarea are sens doar pentru un str.

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.