.replace()

Replace a specific substring with another substring.

Syntax

string.replace(old, new, count)

The .replace() string method takes in three parameters:

• old: The substring to search for. (Required)
• new: The substring to replace. (Required)
• count: A number specifying how many occurrences of the old value to replace. Default is all occurrences.

Example 1

.replace() can be called either directly on a string:

welcome = "Hello, world!".replace("world", "Codecademy")

print(welcome)
# Output: Hello, Codecademy!

Or on a variable assigned to a string:

welcome = "Hello, world!"
welcome = welcome.replace("world", "Codecademy")

print(welcome)
# Output: Hello, Codecademy!

Because replace() is a method, it returns a new string and does not modify the original string. Therefore:

var = "x"
var.replace("x", "y")
print(var)
# Output: x

By default, replace() will replace all occurrences in the string. However, you can add an integer to specify how many strings should be replaced.

var = "I like cats and cats like me"
var = var.replace("like", "LOVE")
print(var)
# Output: "I LOVE cats and cats LOVE me"

var = "I like cats and cats like me"
var = var.replace("like", "LOVE", 1)
print(var)
# Output "I LOVE cats and cats like me"

Examples

The replace() method can be used to remove sections of a string entirely:

us
Visit us
code
Hide code
Code
Output
Hide output
Hide output
Loading...
Run

It can also be called multiple times on the same string:

us
Visit us
code
Hide code
Code
Output
Hide output
Hide output
Loading...
Run

If there are many words that need to be removed, consider using a for loop:

us
Visit us
code
Hide code
Code
Output
Hide output
Hide output
Loading...
Run