str.replace()

Метод replace() возвращает копию строки, в которой все вхождения подстроки old заменены на подстроку new. Можно ограничить количество замен через параметр count.

Сигнатура

str.replace(old, new, count=-1)

Параметры

  • old — подстрока, которую нужно заменить.

  • new — подстрока, на которую производится замена.

  • count — максимальное количество замен. Если -1 (по умолчанию) — заменяются все вхождения. Если 0 — замен не происходит.

Возвращаемое значение

Новая строка (str) с произведёнными заменами. Исходная строка не меняется.

Примеры использования

Пример 1. Простая замена.

text = "Arduino — это весело"
print(text.replace("весело", "интересно"))

Arduino — это интересно

Пример 2. Замена всех вхождений.

s = "ESP32 ESP32 ESP32"
print(s.replace("ESP32", "STM32"))

STM32 STM32 STM32

Пример 3. Ограничение числа замен.

s = "a-b-c-d-e"
print(s.replace("-", "_", 2))

a_b_c-d-e

Пример 4. Edge case — подстрока не найдена.

text = "Привет, мир"
print(text.replace("Java", "Python"))

Привет, мир

Если old не найдена, возвращается исходная строка без изменений.

Пример 5. Практическое применение — удаление символов.

Если в качестве new передать пустую строку, метод фактически удаляет все вхождения old:

phone = "+7 (701) 123-45-67"
digits = phone.replace(" ", "").replace("(", "").replace(")", "").replace("-", "").replace("+", "")
print(digits)

77011234567

См. также

Примечание

Лицензия и источники

Техническое описание метода адаптировано из официальной документации Python (https://docs.python.org), доступной под Python Software Foundation License Version 2. Перевод на русский, примеры использования и пояснения — © AlashEd Wiki.