AttributeError: 'list' object has no attribute 'replace'

avatar

Borislav Hadzhiev

Last updated: Apr 20, 2022

banner

Photo from Unsplash

AttributeError: 'list' object has no attribute 'replace' #

The Python "AttributeError: 'list' object has no attribute 'replace'" occurs when we call the replace() method on a list instead of a string. To solve the error, call replace() on a string, e.g. by accessing the list at a specific index or by iterating over the list.

attributeerror list object has no attribute replace

Here is an example of how the error occurs.

main.py
my_list = ['hello', 'world'] # ⛔️ AttributeError: 'list' object has no attribute 'replace' my_list.replace('l', '_')

We created a list with 2 elements and tried to call the replace() method on the list which caused the error.

The replace() method is string-specific, so we have to call it on a string, and not on a list object.

One way to solve the error is to access the list at a specific index before calling replace().

main.py
my_list = ['hello', 'world'] result = my_list[0].replace('l', '_') print(result) # 👉️ "he__o"

We accessed the list element at index 0 and called the replace() method on the string.

If you need to call the replace() method on each string in a list, use a list comprehension.

main.py
my_list = ['hello', 'world'] new_list = [element.replace('l', '_') for element in my_list] print(new_list) # 👉️ ['he__o', 'wor_d']

Alternatively you can use a for loop to call the replace method on each string in the list.

main.py
my_list = ['hello', 'world'] for word in my_list: result = word.replace('l', '_') print(result) # 👉️ "he__o", "wor_d"

We used a for loop to iterate over the list and called the replace() method on each string.

The str.replace method returns a copy of the string with all occurrences of a substring replaced by the provided replacement.

The method takes the following parameters:

NameDescription
oldThe substring we want to replace in the string
newThe replacement for each occurrence of old
countOnly the first count occurrences are replaced (optional)
The "AttributeError: 'list' object has no attribute 'replace'" occurs when we try to call the replace() method on a list instead of a string.

To solve the error, you either have to correct the assignment of the variable and make sure to call replace() on a string, or call replace() on an element in the list that is of type string.

You can either access the list at a specific index, e.g. my_list[0] or use a for loop to iterate over the list if you have to call replace() on each element.

You can view all the attributes an object has by using the dir() function.

main.py
my_list = ['a', 'b', 'c'] # 👉️ [... 'append', 'clear', 'copy', 'count', 'extend', 'index', # 'insert', 'pop', 'remove', 'reverse', 'sort' ...] print(dir(my_list))

If you pass a class to the dir() function, it returns a list of names of the class's attributes, and recursively of the attributes of its bases.

If you try to access any attribute that is not in this list, you would get the "AttributeError: list object has no attribute" error.

Since replace() is not a method implemented by lists, the error is caused.

Conclusion #

The Python "AttributeError: 'list' object has no attribute 'replace'" occurs when we call the replace() method on a list instead of a string. To solve the error, call replace() on a string, e.g. by accessing the list at a specific index or by iterating over the list.

I wrote a book in which I share everything I know about how to become a better, more efficient programmer.
book cover
You can use the search field on my Home Page to filter through all of my articles.