TypeError: string argument without an encoding
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
date = bytes("parolă")
print(len(date))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
buffer = bytearray("salut")
buffer[0] = 83
print(buffer)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()
mesaj = "Bună ziua"
octeti = bytes(mesaj)
print(octeti)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ă 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.
mesaj = "Bună ziță"
octeti = bytes(mesaj)
print("Caractere:", len(mesaj))
print("Octeti:", len(octeti))Caractere: 9 Octeti: 12
Indiciu
Funcția bytes are nevoie și de numele codificării când primește un text.
Reparația
mesaj = "Bună ziță"
octeti = bytes(mesaj, "utf-8")
print("Caractere:", len(mesaj))
print("Octeti:", len(octeti))De ce merge
Un text devine octeți doar printr-o codificare, iar bytes(mesaj) nu o primea. Cu bytes(mesaj, "utf-8") (sau mesaj.encode("utf-8")), fiecare caracter e scris în UTF-8: literele simple ocupă un octet, iar fiecare ă și ț ocupă doi. De aceea cele 9 caractere devin 12 octeți.
Alte forme ale mesajului
TypeError: encoding without a string argument
Cum o eviți pe viitor
- Ține minte regula: din
strînbytestreci cu.encode("utf-8"), dinbytesînstrcu.decode("utf-8"). - Scrie mereu codificarea explicit, chiar dacă
utf-8e implicit laencode(): 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
TypeError: a bytes-like object is required, not 'str' Amesteci bytes (`b"..."`) cu texte (`str`): de exemplu faci `split(",")` pe date binare, cauți un text într-un bytes sau scrii text într-un fișier deschis cu `"wb"`. Decodează datele cu `.decode("utf-8")` sau lucrează doar cu bytes (`b","`). UnicodeEncodeError: 'ascii' codec can't encode character '\u0219' in position 3: ordinal not in range(128) Încerci să transformi în bytes (să scrii, să afișezi sau să trimiți) un text cu diacritice folosind un encoding care nu le are, de obicei ASCII. Folosește UTF-8: `text.encode("utf-8")`, `open(..., encoding="utf-8")` sau setează `PYTHONIOENCODING=utf-8` pentru terminal. TypeError: Strings must be encoded before hashing Funcțiile din hashlib (sha256, md5...) lucrează pe octeți, nu pe text. Transformă textul cu .encode("utf-8") înainte: hashlib.sha256(parola.encode("utf-8")).hexdigest(). Î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.
