The str() function in Python is an in-built function that takes an object as input and returns its string representation. It can be used to convert various data types into strings, which can then be used for printing, concatenation, and formatting. Let’s take a simple example to converting an Integer to string.

n = 123
s = str(n)
print(s)

123

Explanation: Here, integer 123 is passed to str() function, which returns the string '123'.

Syntax

str(object, encoding='utf-8', errors='strict')

Parameters:

• object (optional): The value to be converted. Can be any Python object (e.g., int, float, list, dict, bytes).
• encoding (optional): Used only when converting from bytes. Default is 'utf-8'.
• errors (optional): Specifies how to handle decoding errors:
  • 'strict': Raises an error (default).
  • 'ignore': Skips invalid characters.
  • 'replace': Replaces invalid characters with ?.

Return Type:

• Returns a string representation of the object.
• Returns an empty string "" if no argument is passed.

Examples of str() function

Example 1. Converting an Integer to String

n = 123
s = str(n)
print(s, type(s))

123 <class 'str'>

Explanation: The integer 123 is converted into the string '123'.

Example 2. Convert a Float to a String

pi = 3.14159
s = str(pi)
print(s)

3.14159

Explanation: The floating-point number 3.14159 is transformed into the string '3.14159'.

Example 3. Converting a List to a String

a = [1, 2, 3]
s = str(a)
print(s)

[1, 2, 3]

Explanation: The list [1, 2, 3] is converted into the string representation '[1, 2, 3]'.

Example 4. Converting a Dictionary to a String

b = {'name': 'Alice', 'age': 25}
s = str(b)
print(s)

{'name': 'Alice', 'age': 25}

Explanation: The dictionary {'name': 'Alice', 'age': 25} is represented as a string.

Example 5. Converting a Byte Object to String (with Encoding)

In this example, we’ll convert a byte object representing text into a string. By specifying the encoding, str() can correctly interpret the byte data as text.

bd = b'Python programming'

txt = str(bd, encoding='utf-8')
print(txt)

Python programming

Explanation: str(bd, encoding='utf-8') decodes the byte string using UTF-8.

Example 6. Handling Decoding Errors with errors='ignore'

Sometimes, byte data may contain invalid characters or sequences for a given encoding. The errors parameter allows us to control how these issues are handled. Using errors='ignore', we can skip invalid characters during conversion.

bd = b'Hi \x80\x81'

t = str(bd, encoding='utf-8', errors='ignore')
print(t)

Hi 

Explanation: Here, \x80 and \x81 are invalid UTF-8 byte sequences. By setting errors='ignore', these invalid characters are simply omitted from the output, resulting in a clean, readable string.

Example 7. Handling Decoding Errors with errors='replace'

Using errors='replace', we can substitute any problematic characters with a placeholder symbol (often a question mark, ?), so it’s clear where data was altered during conversion.

bd = b'Hello world \x80\x81'

t = str(bd, encoding='utf-8', errors='replace')
print(t)

Hello world ��

Explanation: invalid byte sequences \x80 and \x81 are replaced by ?, indicating that there were unrecognized characters in the data. This is helpful when we want to keep the original format of text without causing any errors when reading it.

Example 8. Raising an Error on Invalid Bytes with errors='strict'

Using errors='strict' raises a UnicodeDecodeError for any invalid byte sequence in the specified encoding, ensuring data conversion accuracy.

bd = b'Hi \x80\x81'

try:
    t = str(bd, encoding='utf-8', errors='strict')
    print(t)
except UnicodeDecodeError as e:
    print("Error:", e)

Error: 'utf-8' codec can't decode byte 0x80 in position 3: invalid start byte

Explanation: byte_data_invalid contains invalid UTF-8 sequences (\x80 and \x81). Using errors='strict' causes Python to raise a UnicodeDecodeError, stopping the conversion and providing an error message.

Common Use Cases:

• Convert values (like integers, floats, lists) to strings for printing or logging.
• Convert byte data to readable text using encoding.
• Handle decoding issues using errors parameter.

Read articles:

• byte object
• encoding
• decoding