How to Decode Bytes to String in Python: Simple Guide

In Python, you can convert bytes to a string using the decode() method on a bytes object. For example, my_bytes.decode('utf-8') converts bytes to a string using UTF-8 encoding.

Syntax

The decode() method is called on a bytes object to convert it into a string. You specify the encoding used to interpret the bytes, commonly 'utf-8'.

• bytes_object.decode(encoding): Converts bytes to string.
• encoding: The character encoding (like 'utf-8', 'ascii', etc.).

python

decoded_string = bytes_object.decode('utf-8')

Example

This example shows how to decode a bytes object containing UTF-8 encoded text into a Python string.

python

my_bytes = b'Hello, world!'
my_string = my_bytes.decode('utf-8')
print(my_string)

Output

Hello, world!

Common Pitfalls

Common mistakes include:

• Not specifying the correct encoding, which can cause errors or wrong characters.
• Trying to decode a string instead of bytes, which raises an AttributeError.
• Using decode() on data that is not bytes.

python

# Wrong: decoding a string (raises error)
try:
    text = 'hello'.decode('utf-8')
except AttributeError as e:
    print(f'Error: {e}')

# Right: decoding bytes
text = b'hello'.decode('utf-8')
print(text)

Output

Error: 'str' object has no attribute 'decode'
hello

Quick Reference

Method	Description	Example
decode(encoding)	Converts bytes to string using given encoding	b'abc'.decode('utf-8') # 'abc'
Common encodings	Popular encoding names	'utf-8', 'ascii', 'latin-1'
Error	Raises UnicodeDecodeError if bytes can't be decoded	b'\xff'.decode('utf-8')

Key Takeaways

Use the decode() method on bytes to convert them to a string.

Always specify the correct encoding like 'utf-8' to avoid errors.

Do not call decode() on a string; it only works on bytes.

If decoding fails, check the bytes and encoding compatibility.

Common encodings include 'utf-8', 'ascii', and 'latin-1'.