Как работает метод replace python?
Строковый метод str.replace(old, new[, count]) вернет копию строки, в которой все подстроки old будут заменены на new. Если указать необязательный параметр count, то не все old, а только указанное количество будет заменено.
'The Young Pope'.replace('Young', 'New') # 'The New Pope' 'One Hundred and One Dalmatians'.replace('One', '1', 1) # '1 Hundred and One Dalmatians' String.prototype.replace()
Метод replace() возвращает новую строку с некоторыми или всеми сопоставлениями с шаблоном, заменёнными на заменитель. Шаблон может быть строкой или регулярным выражением, а заменитель может быть строкой или функцией, вызываемой при каждом сопоставлении.
Синтаксис
str.replace(regexp|substr, newSubStr|function[, flags])
Параметры
Объект регулярного выражения RegExp . Сопоставление заменяется возвращаемым значением второго параметра.
Строка, заменяемая на newSubStr . Обратите внимание, будет заменено только первое вхождение искомой строки.
Строка, заменяющая подстроку из первого параметра. Поддерживает несколько специальных шаблонов замены; смотрите ниже раздел Передача строки в качестве второго параметра.
Функция, вызываемая для создания новой подстроки (помещаемой вместо подстроки из первого параметра). Аргументы, передаваемые функции, описаны ниже в разделе Передача функции в качестве второго параметра.
Обратите внимание: аргумент flags не работает в ядре v8 (движок JavaScript в Chrome и NodeJs). Строка, задающая комбинацию флагов регулярного выражения. Параметр flags в методе String.prototype.replace() является нестандартным расширением. Вместо использования этого параметра используйте объект RegExp с соответствующими флагами. Значение этого параметра, если он используется, должно быть строкой, состоящей из одного или более следующих символов, следующим образом влияющих на обработку регулярного выражения:
сопоставление по нескольким строкам
«липкий» поиск, сопоставление начинается с текущей позиции в строке
Возвращаемое значение
Новая строка с некоторыми или всеми сопоставлениями шаблона, заменёнными на заменитель.
Описание
Этот метод не изменяет объект String , на котором он вызывается. Он просто возвращает новую строку.
Для выполнения глобального поиска и замены либо включите флаг g в регулярное выражение, либо, если первый параметр является строкой, включите флаг g в параметр flags .
Передача строки в качестве второго параметра
строка замены может включать следующие специальные шаблоны замены:
| Шаблон | Замена |
|---|---|
| $$ | Вставляет символ доллара «$». |
| $& | Вставляет сопоставившуюся подстроку. |
| $` | Вставляет часть строки, предшествующую сопоставившейся подстроке. |
| $’ | Вставляет часть строки, следующую за сопоставившейся подстрокой. |
| $n или $nn | Символы n или nn являются десятичными цифрами, вставляет n-ную сопоставившуюся подгруппу из объекта RegExp в первом параметре. |
Передача функции в качестве второго параметра
В качестве второго параметра вы можете передать функцию. В этом случае функция будет выполнена после произошедшего сопоставления. Результат вызова функции (её возвращаемое значение) будет использоваться в качестве строки замены (обратите внимание: описанные выше специальные шаблоны замены в этом случае не применяются). Обратите внимание, что функция будет вызвана несколько раз для каждого полного сопоставления, если регулярное выражение в первом параметре является глобальным.
Функция принимает следующие аргументы:
| Возможное имя | Получаемое значение |
|---|---|
| match | Сопоставившаяся подстрока (соответствует шаблону замены $& , описанному выше). |
| p1, p2, . | n-ная сопоставившаяся подгруппа из объекта RegExp в первом параметре метода replace() (соответствует шаблонам замены $1 , $2 и так далее, описанным выше). Например, если в качестве шаблона передано регулярное выражение /(\a+)(\b+)/ , параметр p1 будет значение сопоставления с подгруппой \a+ , а параметр p2 — с подгруппой \b+ . |
| offset | Смещение сопоставившейся подстроки внутри всей рассматриваемой строки (например, если вся строка равна ‘abcd’ , а сопоставившаяся подстрока равна ‘bc’ , то этот аргумент будет равен 1). |
| string | Вся рассматриваемая строка. |
Точное число аргументов будет зависеть от того, был ли первым аргументом объект RegExp и, если был, сколько подгрупп в нём определено.
Следующий пример установит переменную newString в значение ‘abc — 12345 — #$*%’ :
function replacer(match, p1, p2, p3, offset, string) // p1 - не цифры, p2 - цифры, p3 - не буквы и не цифры return [p1, p2, p3].join(" - "); > var newString = "abc12345#$*%".replace(/([^\d]*)(\d*)([^\w]*)/, replacer);
Примеры
Пример: использование флагов global и ignore с методом replace()
В следующем примере регулярное выражение включает флаги для глобального поиска и игнорирования регистра, которые позволяют методу replace() заменить все вхождения слова «яблоки» в строке на слово «апельсины».
var re = /яблоки/gi; var str = "Яблоки круглые и яблоки сочные."; var newstr = str.replace(re, "апельсины"); console.log(newstr); // апельсины круглые и апельсины сочные.
Пример: передача регулярного выражения в метод replace()
В следующем примере в метод replace() передаётся регулярное выражение вместе с флагом игнорирования регистра.
// Ночь перед Рождеством, Xmas - сокращение для Christmas var str = "Twas the night before Xmas. "; var newstr = str.replace(/xmas/i, "Christmas"); console.log(newstr); // Twas the night before Christmas.
Пример выведет строку ‘Twas the night before Christmas. ‘
Пример: смена местами слов в строке
Следующий скрипт меняет местами слова в строке. В качестве текста замены он использует шаблоны замены $1 и $2 .
var re = /([А-ЯЁа-яё]+)\s([А-ЯЁа-яё]+)/; var str = "Джон Смит"; var newstr = str.replace(re, "$2, $1"); console.log(newstr); // Смит, Джон
Пример выведет строку ‘Смит, Джон’.
Пример: использование функции для изменения сопоставившихся символов
В этом примере все входящие в строку (латинские) буквы в верхнем регистре преобразуются в нижний регистр, а перед самой буквой вставляется дефис. Здесь важно то, что прежде чем элемент вставится в качестве замены, над ним нужно провести дополнительные преобразования.
Функция замены своим параметром принимает сопоставившийся кусок и перед возвратом использует его для преобразования регистра и соединения с дефисом.
function styleHyphenFormat(propertyName) function upperToHyphenLower(match) return "-" + match.toLowerCase(); > return propertyName.replace(/[A-Z]/g, upperToHyphenLower); >
Вызов styleHyphenFormat(‘borderTop’) вернёт строку ‘border-top’.
Поскольку мы хотим провести дополнительные преобразования результата сопоставления до того, как будет использована окончательная подстановка, мы должны использовать функцию. Это заставляет нас принудительно вычислить сопоставление перед использование метода toLowerCase() . Если бы мы попытались использовать сопоставление без функции, метод toLowerCase() не сработал бы.
var newString = propertyName.replace(/[A-Z]/g, "-" + "$&".toLowerCase()); // не работает
Происходит это потому, что сначала часть ‘$&’.toLowerCase() вычисляется в строковый литерал (результат по-прежнему равен ‘$&’ ), а только потом его символы используются в качестве шаблона.
Пример: замена градусов по Фаренгейту на эквивалент в градусах по Цельсию
В следующем примере градусы по Фаренгейту заменяются на эквивалентные градусы по Цельсию. Градусы по Фаренгейту должны быть числом, оканчивающимся на букву F. Функция возвращает количество градусов по Цельсию, оканчивающиеся на букву C. Например, если входное число равняется 212F, функция вернёт 100C. Если число равняется 0F, функция вернёт -17.77777777777778C.
Регулярное выражение test сопоставляется с любым числом, оканчивающимся на букву F. Количество градусов по Фаренгейту передаётся в функцию через её второй параметр, p1 . Функция переводит градусы по Фаренгейту, переданные в виде строки в функцию code>f2c(), в градусы по Цельсию. Затем функция f2c() возвращает количество градусов по Цельсию. Эта функция работает примерно так же, как и флаг s///e в Perl.
function f2c(x) function convert(str, p1, offset, s) return ((p1 - 32) * 5) / 9 + "C"; > var s = String(x); var test = /(\d+(?:\.\d*)?)F\b/g; return s.replace(test, convert); >
Пример: использование функции вместе с регулярным выражением для избавления от цикла for
Следующий пример принимает строку шаблона и преобразует её в массив объектов.
Входные данные:
Строка, состоящая из символов x , — и _
x-x_ x---x---x---x--- x-xxx-xx-x- x_x_x___x___x___
Выходные данные:
Массив объектов. Символ ‘x’ означает состояние ‘on’ , символ ‘-‘ (дефис) означает состояние ‘off’ , а символ ‘_’ (нижнее подчёркивание) означает продолжительность состояния ‘on’ .
[ on: true, length: 1 >, on: false, length: 1 >, on: true, length: 2 > . ]
Код:
var str = "x-x_"; var retArr = []; str.replace(/(x_*)|(-)/g, function (match, p1, p2) if (p1) retArr.push( on: true, length: p1.length >); > if (p2) retArr.push( on: false, length: 1 >); > >); console.log(retArr);
Этот код сгенерирует массив из трёх объектов в описанном формате без использования цикла for .
Спецификации
| Specification |
|---|
| ECMAScript Language Specification # sec-string.prototype.replace |
Совместимость с браузерами
BCD tables only load in the browser
Смотрите также
- String.prototype.match()
- RegExp.prototype.exec()
- RegExp.prototype.test()
Found a content problem with this page?
- Edit the page on GitHub.
- Report the content issue.
- View the source on GitHub.
This page was last modified on 7 авг. 2023 г. by MDN contributors.
Your blueprint for a better internet.
MDN
Support
- Product help
- Report an issue
Our communities
Developers
- Web Technologies
- Learn Web Development
- MDN Plus
- Hacks Blog
- Website Privacy Notice
- Cookies
- Legal
- Community Participation Guidelines
Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998– 2023 by individual mozilla.org contributors. Content available under a Creative Commons license.
Артём Санников
Данная книга является руководством для начинающих специалистов в области анализа и обработки данных. В книге рассматривается язык SQL и его процедурное расширение PL/SQL от компании Oracle.
Главная › Языки программирования › Python › Работа со строками › Функция replace() в Python
Функция replace() в Python
Функция replace() в Python позволяет произвести замену символов в строке.
Синтаксис функции replace()
replace(старое_значение, новое_значение, количество_замен)
Практический пример
Определяем переменную str и присваиваем ей необходимое значение. Затем вызываем функцию replace() и передаём ей три параметра: старое значение, новое значение и количество производимых замен. После того, как произвели замену в строке выводим финальный результат на экран.
Обратите внимание: если вы не укажете третий параметр, то Python произведёт замену всех значений в строке.
# Определяем переменную str str = "это тестовая строка" # Выполняем операцию с переменной str result = str.replace("о", "О", 2) # Выводим результат на экран print(result) # Финальный результат в консоли этО тестОвая строка
Записи по теме
- Функция center() в Python
- Функция startswith() и endswith() в Python
- Функция ord() и chr() в Python
- Функция ljust() и rjust() в Python
- Функция zfill() в Python
- Обращение по индексу в строке Python
- Длина строки в Python
- Повторение строки в Python
replace()
Метод replace() ищет строку для указанного значения или регулярное выражение и возвращает новую строку, где указанные значения заменяются.
Примечание. Если вы заменяете значение (а не регулярное выражение), будет заменен только первый экземпляр значения. Чтобы заменить все вхождения указанного значения, используйте глобальный ( g ) модификатор (см. “Дополнительные примеры”).
Этот метод не изменяет исходную строку.
Поддержка браузеров
Синтаксис
Значения параметров
| Параметр | Описание |
| searchvalue | Обязательный. Значение или регулярное выражение, которое будет заменено новым значением |
| newvalue | Обязательный. Значение для замены значения поиска |
Технические подробности
| Возвращаемое значение: | Новая строка, в которой указанные значения были заменены новыми значениями |
| Версия JavaScript: | ECMAScript 1 |
Дополнительные примеры
Выполнит глобальную замену:
var string = "Mrs Black has a black dog and a black car"; var result = string.replace(/black/g, "white"); // Mrs Black has a white dog and a white car
Выполнит глобальную замену без учета регистра:
var string = "Mrs Black has a black dog and a black car"; var result = string.replace(/black/gi, "white"); // Mrs white has a white dog and a white car
Использование функции для возврата текста замены:
var string = "Mrs Black has a black dog and a black car"; var result = string .replace(/black|dog|car/gi, function myFunction(x)< return x.toUpperCase();>); // Mrs BLACK has a BLACK DOG and a BLACK CAR