--- title: 4.25 String Replacement description: "String replacement is the process of substituting one character or substring with another. Python provides the **`replace()`** method to replace one or more occurrences of a specified substring with a new substring. The `replace()` method returns a **new string** because…" url: "https://edcret.in/docs/python-programming/strings-python/4-25-string-replacement/" updated: "2026-07-29" category: Python Programming / Strings --- # 4.25 String Replacement String replacement is the process of substituting one character or substring with another. Python provides the **`replace()`** method to replace one or more occurrences of a specified substring with a new substring. The `replace()` method returns a **new string** because strings in Python are immutable. The original string remains unchanged. String replacement is commonly used for correcting text, formatting data, sanitizing user input, modifying file paths, and preparing data for processing. --- ## Syntax ``` string.replace(old, new) ``` or ``` string.replace(old, new, count) ``` ### Components | Component | Description | | --- | --- | | `string` | The original string. | | `old` | The substring to be replaced. | | `new` | The replacement substring. | | `count` | Maximum number of replacements (optional). | --- ## Example 1: Replacing a Word **main.py** ``` text = "I like Python." print(text.replace("Python", "Java")) ``` ### Output ``` I like Java. ``` ### Explanation - `replace()` searches for `"Python"`. - It replaces the word with `"Java"`. - A new string is returned. --- ## Example 2: Replacing All Occurrences **main.py** ``` text = "cat bat cat bat" print(text.replace("cat", "dog")) ``` ### Output ``` dog bat dog bat ``` ### Explanation - Every occurrence of `"cat"` is replaced. - The word `"dog"` takes its place. - By default, all matches are replaced. --- ## Example 3: Replacing Only the First Occurrence **main.py** ``` text = "cat bat cat bat" print(text.replace("cat", "dog", 1)) ``` ### Output ``` dog bat cat bat ``` ### Explanation - The third argument specifies the maximum number of replacements. - Only the first `"cat"` is replaced. - The remaining occurrences are unchanged. --- ## Example 4: Replacing a Character **main.py** ``` text = "banana" print(text.replace("a", "@")) ``` ### Output ``` b@n@n@ ``` ### Explanation - Each `"a"` is replaced with `"@"`. - Character replacement works the same way as substring replacement. - All occurrences are replaced. --- ## Example 5: User Input **main.py** ``` message = input("Enter a sentence: ") print(message.replace(" ", "_")) ``` ### Sample Input ``` Python is fun ``` ### Output ``` Python_is_fun ``` ### Explanation - The user enters a sentence. - Every space is replaced with an underscore. - The formatted string is displayed. --- ## Example 6: Removing Characters **main.py** ``` phone = "123-456-7890" print(phone.replace("-", "")) ``` ### Output ``` 1234567890 ``` ### Explanation - The replacement string is empty (`""`). - Each hyphen is removed. - The remaining characters are joined together. --- ## Example 7: Replacing a Substring **main.py** ``` text = "Python Programming" print(text.replace("Programming", "Language")) ``` ### Output ``` Python Language ``` ### Explanation - The substring `"Programming"` is replaced. - `"Language"` becomes the new substring. - The rest of the string remains unchanged. --- ## Example 8: No Match Found **main.py** ``` text = "Python" print(text.replace("Java", "C++")) ``` ### Output ``` Python ``` ### Explanation - `"Java"` does not exist in the string. - No replacement occurs. - The original string is returned. --- ## Example 9: Checking the Return Type **main.py** ``` text = "Python" result = text.replace("P", "J") print(type(result)) ``` ### Output ``` ``` ### Explanation - `replace()` returns a new string. - The returned object is of type `str`. --- ## Example 10: Replacing Multiple Spaces **main.py** ``` text = "Python Programming" print(text.replace(" ", "-")) ``` ### Output ``` Python---Programming ``` ### Explanation - Every individual space is replaced. - Since there are three spaces, three hyphens appear. - `replace()` works character by character when replacing single characters. --- # Common Mistakes ### 1. Assuming `replace()` Changes the Original String **Incorrect** ``` text = "Python" text.replace("Python", "Java") print(text) ``` ### Output ``` Python ``` **Reason** `replace()` returns a new string. The original string remains unchanged. **Correct** ``` text = text.replace("Python", "Java") print(text) ``` --- ### 2. Expecting Only the First Match to Be Replaced **Incorrect** ``` text = "cat cat cat" print(text.replace("cat", "dog")) ``` ### Incorrect Expectation ``` dog cat cat ``` ### Actual Output ``` dog dog dog ``` **Reason** By default, `replace()` replaces all occurrences. **Correct** ``` print(text.replace("cat", "dog", 1)) ``` --- ### 3. Forgetting That Replacement Is Case-Sensitive **Incorrect** ``` text = "Python" print(text.replace("python", "Java")) ``` ### Output ``` Python ``` **Reason** `replace()` is case-sensitive. `"Python"` and `"python"` are different strings. --- ### 4. Assuming `replace()` Raises an Error When No Match Exists **Incorrect** ``` text = "Python" print(text.replace("Java", "C++")) ``` ### Incorrect Expectation ``` ValueError ``` ### Actual Output ``` Python ``` **Reason** If the substring is not found, the original string is returned unchanged. --- # Best Practices - Store the returned string if the replacement needs to be preserved. - Use the `count` parameter when only a limited number of replacements are required. - Remember that `replace()` is case-sensitive. - Use an empty string (`""`) as the replacement when removing characters. - Use descriptive variable names when performing string replacements. --- # Key Points to Remember - `replace()` substitutes one substring with another. - By default, all matching occurrences are replaced. - The optional `count` parameter limits the number of replacements. - `replace()` returns a new string. - The original string remains unchanged. - String replacement is case-sensitive. - If the substring is not found, the original string is returned.