regexprep

Замените текст с помощью регулярного выражения

Синтаксис

newStr = regexprep(str,expression,replace)
newStr = regexprep(str,expression,replace,option1,...optionM)

Описание

пример

newStr = regexprep(str,expression,replace) заменяет текст в str, который совпадает с expression тексту, описанному replace. Функция regexprep возвращает обновленный текст в newStr.

  • Если str является одной частью текста (или вектор символов или скаляр строки), то newStr является также одной частью текста того же типа. newStr является одной частью текста, даже когда expression или replace являются массивом ячеек из символьных векторов или массивом строк. Когда expression является массивом ячеек или массивом строк, regexprep применяет первое выражение к str, и затем применяет каждое последующее выражение к предыдущему результату.

  • Если str является массивом ячеек или массивом строк, то newStr является массивом ячеек или массивом строк с теми же размерностями как str. Для каждого элемента str функция regexprep применяет каждое выражение в последовательности.

  • Если нет никаких соответствий к expression, то newStr эквивалентен str.

пример

newStr = regexprep(str,expression,replace,option1,...optionM) изменяет поиск с помощью заданных опций. Например, задайте 'ignorecase', чтобы выполнить нечувствительное к регистру соответствие.

Примеры

свернуть все

Замените слова, которые начинаются с M, конца с y, и имеют по крайней мере один символ между ними.

str = 'My flowers may bloom in May';
expression = 'M(\w+)y';
replace = 'April';

newStr = regexprep(str,expression,replace)
newStr = 
'My flowers may bloom in April'

Замените изменения фразы 'walk up' путем получения букв, которые следуют за 'walk' в лексеме.

str = 'I walk up, they walked up, we are walking up.';
expression = 'walk(\w*) up';
replace = 'ascend$1';

newStr = regexprep(str,expression,replace)
newStr = 
'I ascend, they ascended, we are ascending.'

Замените строчные буквы в начале предложений с их прописными эквивалентами с помощью функции upper.

str = 'here are two sentences. neither is capitalized.';
expression = '(^|\.)\s*.';
replace = '${upper($0)}';

newStr = regexprep(str,expression,replace)
newStr = 
'Here are two sentences. Neither is capitalized.'

Регулярное выражение совпадает с отдельными символами (.), которые следуют за началом вектора символов (^) или период (\.) и любой пробел (\s*). Выражение replace вызывает функцию upper для в настоящее время соответствующего символа ($0).

Замените каждое вхождение двойной буквы в наборе векторов символов с символами '--'.

str = {                                 ...
'Whose woods these are I think I know.' ; ...
'His house is in the village though;'   ; ...
'He will not see me stopping here'      ; ...
'To watch his woods fill up with snow.'};

expression = '(.)\1';
replace = '--';
newStr = regexprep(str,expression,replace)
newStr = 4x1 cell array
    {'Whose w--ds these are I think I know.'}
    {'His house is in the vi--age though;'  }
    {'He wi-- not s-- me sto--ing here'     }
    {'To watch his w--ds fi-- up with snow.'}

Проигнорируйте регистр в регулярном выражении при нахождении соответствий, но подражайте регистру исходного текста при обновлении.

str = 'My flowers may bloom in May';
expression = 'M(\w+)y';
replace = 'April';

newStr = regexprep(str,expression,replace,'preservecase')
newStr = 
'My flowers april bloom in April'

Вставьте текст в начале вектора символов с помощью оператора '^', который возвращает соответствие нулевой длины и ключевое слово 'emptymatch'.

str = 'abc';
expression = '^';
replace = '__';

newStr = regexprep(str,expression,replace,'emptymatch')
newStr = 
'__abc'

Входные параметры

свернуть все

Текст, чтобы обновить, заданный как вектор символов, массив ячеек из символьных векторов или массив строк.

Типы данных: char | cell | string

Регулярное выражение, заданное как вектор символов, массив ячеек из символьных векторов или массив строк. Каждое выражение может содержать символы, метасимволы, операторы, лексемы и флаги, которые задают шаблоны, чтобы соответствовать в str.

Следующие таблицы описывают элементы регулярных выражений.

Метасимволы

Метасимволы представляют буквы, обозначают буквами области значений, цифры и пробелы. Используйте их, чтобы создать обобщенный шаблон символов.

Метасимвол

Описание

Пример

.

Любой отдельный символ, включая пробел

'..ain' совпадает с последовательностями пяти последовательных символов тот конец с 'ain'.

[c1c2c3]

Любой символ содержится в квадратных скобках. Следующие символы обработаны буквально: $ | . * + ? и - если не раньше указывали на область значений.

'[rp.]ain' совпадает с 'rain' или 'pain' или '.ain'.

[^c1c2c3]

Любой символ, не содержавший в квадратных скобках. Следующие символы обработаны буквально: $ | . * + ? и - если не раньше указывали на область значений.

'[^*rp]ain' совпадает со всеми последовательностями с четырьмя буквами, которые заканчиваются в 'ain', кроме 'rain' и 'pain' и '*ain'. Например, это совпадает с 'gain', 'lain' или 'vain'.

[c 1-c2]

Любой символ в области значений c 1 через c 2

'[A-G]' совпадает с отдельным символом в области значений A через G.

\w

Любой алфавитный, числовой, или символ подчеркивания. Для английских наборов символов \w эквивалентен [a-zA-Z_0-9]

'\w*' идентифицирует слово.

\W

Любой символ, который не является алфавитным, числовым, или подчеркивание. Для английских наборов символов \W эквивалентен [^a-zA-Z_0-9]

'\W*' идентифицирует термин, который не является словом.

\s

Любой пробельный символ; эквивалентный [ \f\n\r\t\v]

'\w*n\s' распознает слова, которые заканчивают буквой n, сопровождаемый пробельным символом.

\S

Любой непробельный символ; эквивалентный [^ \f\n\r\t\v]

'\d\S' совпадает с числовой цифрой, сопровождаемой любым непробельным символом.

\d

Любая числовая цифра; эквивалентный [0-9]

'\d*' совпадает с любым количеством последовательных цифр.

\D

Любой символ нецифры; эквивалентный [^0-9]

'\w*\D\>' распознает слова, которые не заканчиваются числовой цифрой.

\oN или \o{N}

Символ восьмеричного значения N

'\o{40}' совпадает с пробелом, заданным восьмеричным 40.

\xN или \x{N}

Символ шестнадцатеричного значения N

'\x2C' совпадает с символом запятой, заданным шестнадцатеричным 2C.

Символьное представление

Оператор

Описание

\a

Предупреждение (звуковой сигнал)

\b

Клавиша Backspace

\f

Перевод формата

\n

Новая строка

\r

Возврат каретки

\t

Горизонтальная вкладка

\v

Вертикальная вкладка

\char

Любой символ с особым значением в регулярных выражениях, с которыми вы хотите совпадать буквально (например, используйте \\, чтобы совпадать с одной наклонной чертой влево),

Кванторы

Кванторы задают число раз, шаблон должен произойти в совпавшем тексте.

Квантор

Совпадает с выражением, когда оно происходит...

Пример

expr*

0 или больше раз последовательно.

'\w*' распознает слово любой длины.

expr?

0 раз или в 1 раз.

'\w*(\.m)?' распознает слова, которые опционально заканчиваются дополнительным .m.

expr+

1 или более раз последовательно.

'<img src="\w+\.gif">' совпадает с HTML-тэгом <img>, когда имя файла содержит один или несколько символов.

expr{m,n}

По крайней мере, времена m, но не больше, чем времена n последовательно.

{0,1} эквивалентен ?.

'\S{4,8}' соответствует между четырьмя и восемью непробельными символами.

expr{m,}

По крайней мере, времена m последовательно.

{0,} и {1,} эквивалентны * и +, соответственно.

'<a href="\w{1,}\.html">' совпадает с HTML-тэгом <a>, когда имя файла содержит один или несколько символов.

expr{n}

Точно времена n последовательно.

Эквивалентный {n,n}.

'\d{4}' совпадает с четырьмя последовательными цифрами.

Кванторы могут появиться в трех режимах, описанных в следующей таблице. q представляет любой из кванторов в предыдущей таблице.

Режим

Описание

Пример

expr q

Жадное выражение: совпадайте с как можно большим количеством символов.

Учитывая текст '<tr><td><p>text</p></td>', выражение '</?t.*>' совпадает со всеми символами между <tr и /td>:

'<tr><td><p>text</p></td>'

expr q?

Ленивое выражение: совпадайте с таким же небольшим количеством символов по мере необходимости.

Учитывая text'<tr><td><p>text</p></td>', выражение '</?t.*?>' заканчивает каждый матч при первом вхождении закрывающей угловой скобки (>):

'<tr>'   '<td>'   '</td>'

expr q +

Притяжательное выражение: соответствуйте как можно больше, но не повторно сканируйте фрагменты текста.

Учитывая text'<tr><td><p>text</p></td>', выражение '</?t.*+>' не возвращает соответствий, потому что закрывающая угловая скобка получена с помощью .* и не повторно сканируется.

Группировка операторов

Группирующиеся операторы позволяют вам получать лексемы, применять один оператор к нескольким элементам или отключать отслеживание в обратном порядке в определенной группе.

Группировка оператора

Описание

Пример

(expr)

Элементы группы выражения и лексем получения.

'Joh?n\s(\w*)' получает лексему, которая содержит фамилию любого человека с именем John или Jon.

(?:expr)

Группа, но не получают лексемы.

'(?:[aeiou][^aeiou]){2}' совпадает с двумя последовательными шаблонами гласного, сопровождаемого негласным, такими как 'anon'.

Без группировки '[aeiou][^aeiou]{2}' совпадает с гласным, сопровождаемым двумя негласными.

(?>expr)

Сгруппируйтесь атомарно. Не отслеживайте в обратном порядке в группе, чтобы завершить соответствие и не получить лексемы.

'A(?>.*)Z' не совпадает с 'AtoZ', несмотря на то, что 'A(?:.*)Z' делает. Используя атомарную группу, Z получен с помощью .* и не повторно сканируется.

(expr1|expr2)

Совпадайте с выражением expr1 или выражение expr2.

Если существует соответствие с expr1, то expr2 проигнорирован.

Можно включать ?: или ?> после вводной круглой скобки, чтобы подавить лексемы или группу атомарно.

'(let|tel)\w+' распознает слова, которые запускаются с let или tel.

Привязки

Привязки в выражении совпадают с началом или концом входного текста или слова.

Привязка

Соответствует...

Пример

^expr

Начало входного текста.

'^M\w*' распознает слово начиная с M в начале текста.

expr$

Конец входного текста.

'\w*m$' распознает слова, заканчивающиеся m в конце текста.

\<expr

Начало слова.

'\<n\w*' распознает любые слова начиная с n.

expr\>

Конец слова.

'\w*e\>' распознает любые слова, заканчивающиеся e.

Утверждения Lookaround

Утверждения Lookaround ищут шаблоны, которые сразу предшествуют или следуют за намеченным соответствием, но не являются частью соответствия.

Указатель остается в текущем местоположении, и символы, которые соответствуют выражению test, не получены или отброшены. Поэтому предварительные утверждения могут совпадать с перекрывающимися группами символов.

Утверждение Lookaround

Описание

Пример

expr(?=test)

Предусмотрите для символов то соответствие test.

'\w*(?=ing)' совпадает с условиями, которые сопровождаются ing, таким как 'Fly' и 'fall' во входном тексте 'Flying, not falling.'

expr(?!test)

Смотрите вперед для символов, которые не совпадают с test.

'i(?!ng)' совпадает с экземплярами буквы i, которые не сопровождаются ng.

(?<=test)expr

Оглянитесь для символов то соответствие test.

'(?<=re)\w*' совпадает с условиями, которые следуют за 're', таким как 'new', 'use' и 'cycle' во входном тексте 'renew, reuse, recycle'

(?<!test)expr

Оглянитесь для символов, которые не совпадают с test.

'(?<!\d)(\d)(?!\d)' совпадает с одноразрядными числами (цифры, которые не предшествуют или следуют за другими цифрами).

Если вы задаете предварительное утверждение, прежде чем выражение, операция будет эквивалентна логическому AND.

Операция

Описание

Пример

(?=test)expr

Совпадайте и с test и с expr.

'(?=[a-z])[^aeiou]' совпадает с согласными.

(?!test)expr

Совпадайте с expr и не совпадайте с test.

'(?![aeiou])[a-z]' совпадает с согласными.

Логические и условные операторы

Логические и условные операторы позволяют вам тестировать состояние данного условия, и затем использовать результат, чтобы определить который шаблон, если таковые имеются, соответствовать затем. Эти операторы поддерживают логический OR, и условия if/else или if.

Условия могут быть лексемами, lookaround операторы или динамические выражения формы (?@cmd). Динамические выражения должны возвратить логическое или числовое значение.

Условный оператор

Описание

Пример

expr1|expr2

Совпадайте с выражением expr1 или выражение expr2.

Если существует соответствие с expr1, то expr2 проигнорирован.

'(let|tel)\w+' распознает слова, которые запускаются с let или tel.

(?(cond)expr)

Если условие, cond является true, то совпадают с expr.

'(?(?@ispc)[A-Z]:\\)' совпадает с именем дисковода, таким как C:\, когда работается система Windows®.

(?(cond)expr1|expr2)

Если условие, cond является true, то совпадают с expr1. В противном случае совпадайте с expr2.

'Mr(s?)\..*?(?(1)her|his) \w*' совпадает с текстом, который включает her, когда текст начинается с Mrs, или это включает his, когда текст начинается с Mr.

Маркерные операторы

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

Порядковый маркерный оператор

Описание

Пример

(expr)

Получите в лексеме символы, которые совпадают с заключенным в нихом выражение.

'Joh?n\s(\w*)' получает лексему, которая содержит фамилию любого человека с именем John или Jon.

\N

Совпадайте с N th лексема.

'<(\w+).*>.*</\1>' получает лексемы для HTML-тэгов, таких как 'title' из текста '<title>Some text</title>'.

(?(N)expr1|expr2)

Если N th лексема найден, то совпадайте с expr1. В противном случае совпадайте с expr2.

'Mr(s?)\..*?(?(1)her|his) \w*' совпадает с текстом, который включает her, когда текст начинается с Mrs, или это включает his, когда текст начинается с Mr.

Названный маркерный оператор

Описание

Пример

(?<name>expr)

Получите в именованной лексеме символы, которые совпадают с заключенным в нихом выражение.

'(?<month>\d+)-(?<day>\d+)-(?<yr>\d+)' создает названные лексемы в течение месяца, дня и года на входной дате формы mm-dd-yy.

\k<name>

Совпадайте с лексемой, упомянутой name.

'<(?<tag>\w+).*>.*</\k<tag>>' получает лексемы для HTML-тэгов, таких как 'title' из текста '<title>Some text</title>'.

(?(name)expr1|expr2)

Если именованная лексема найдена, то совпадайте с expr1. В противном случае совпадайте с expr2.

'Mr(?<sex>s?)\..*?(?(sex)her|his) \w*' совпадает с текстом, который включает her, когда текст начинается с Mrs, или это включает his, когда текст начинается с Mr.

Примечание

Если выражение вложило круглые скобки, MATLAB® получает лексемы, которые соответствуют наиболее удаленному набору круглых скобок. Например, учитывая поисковый шаблон '(and(y|rew))', MATLAB создает лексему для 'andrew', но не для 'y' или 'rew'.

Динамические регулярные выражения

Динамические выражения позволяют вам выполнять команду MATLAB или регулярное выражение, чтобы определить текст, чтобы соответствовать.

Круглые скобки, которые заключают динамические выражения, не создают группу фиксации.

Оператор

Описание

Пример

(??expr)

Проанализируйте expr и включайте получившийся термин в выражении соответствия.

Когда проанализировано, expr должен соответствовать полному, действительному регулярному выражению. Динамические выражения, которые используют символ ESC наклонной черты влево (\), требуют двух наклонных черт влево: один для начального парсинга expr, и один для полного соответствия.

'^(\d+)((??\\w{$1}))' определяет сколько символов, чтобы соответствовать путем чтения цифры в начале соответствия. Динамическое выражение заключено во второй набор круглых скобок так, чтобы получившееся соответствие было получено в лексеме. Например, соответствие с '5XXXXX' получает лексемы для '5' и 'XXXXX'.

(??@cmd)

Выполните команду MATLAB, представленную cmd, и включайте выходной параметр, возвращенный командой в выражении соответствия.

'(.{2,}).?(??@fliplr($1))' находит палиндромы, которые являются по крайней мере четырьмя символами долго, такими как 'abba'.

(?@cmd)

Выполните команду MATLAB, представленную cmd, но отбросьте любой выходной параметр, который возвращает команда. (Полезный для диагностирования регулярных выражений.)

'\w*?(\w)(?@disp($1))\1\w*' распознает слова, которые включают двойные буквы (такие как pp), и промежуточные результаты отображений.

В рамках динамических выражений используйте следующие операторы, чтобы задать текст замены.

Заменяющий оператор

Описание

$& или $0

Фрагмент входного текста, который является в настоящее время соответствием

$`

Фрагмент входного текста, который предшествует текущему соответствию

$'

Фрагмент входного текста, который следует за текущим соответствием (используют $'', чтобы представлять $'),

$N

N th лексема

$<name>

Названная лексема

${cmd}

Выведите возвратился, когда MATLAB выполняет команду, cmd

Комментарии

'characters'

Описание

Пример

(?#comment)

Вставьте комментарий в регулярное выражение. Текст комментария проигнорирован при соответствии с входом.

'(?# Initial digit)\<\d\w+' включает комментарий и распознает слова, которые начинаются с номера.

Поисковые флаги

Поисковые флаги изменяют поведение для соответствия с выражениями. Альтернатива использованию поискового флага в рамках выражения должна передать входной параметр option.

Флаг

Описание

(?-i)

Совпадайте с регистром (значение по умолчанию для regexp и regexprep).

(?i)

Не совпадайте с регистром (значение по умолчанию для regexpi).

(?s)

Совпадайте с точкой (.) в шаблоне с любым символом (значение по умолчанию).

(?-s)

Точка соответствия в шаблоне с любым символом, который не является символом новой строки.

(?-m)

Совпадайте с ^ и метасимволами $ вначале и концом текста (значение по умолчанию).

(?m)

Совпадайте с ^ и метасимволами $ вначале и концом строки.

(?-x)

Включайте пробелы и комментарии при соответствии (значение по умолчанию).

(?x)

Проигнорируйте пробелы и комментарии при соответствии. Используйте '\ ' и '\#', чтобы совпадать с пробелом и символами #.

Выражение, которое изменяет флаг, может появиться любой после круглых скобок, такой как

(?i)\w*

или в круглых скобках и разделенный от флага с двоеточием (:), такой как

(?i:\w*)

Последний синтаксис позволяет вам изменять поведение для части большего выражения.

Типы данных: char | cell | string

Текст замены, заданный как вектор символов, массив ячеек из символьных векторов или массив строк, можно следующим образом:

  • Если replace является односимвольным вектором, и expression является массивом ячеек из символьных векторов, то regexprep использует тот же текст замены для каждого выражения.

  • Если replace является массивом ячеек векторов символов N, и expression является односимвольным вектором, то regexprep делает попытку соответствий N и замен.

  • Если и replace и expression являются массивами ячеек из символьных векторов, то они должны содержать то же число элементов. пары regexprep каждый элемент replace с его соответствием с элементом в expression.

Текст замены может включать регулярные символы, специальные символы (такие как вкладки или новые строки), или заменяющие операторы, как показано в следующих таблицах.

Заменяющий оператор

Описание

$& или $0

Фрагмент входного текста, который является в настоящее время соответствием

$`

Фрагмент входного текста, который предшествует текущему соответствию

$'

Фрагмент входного текста, который следует за текущим соответствием (используют $'', чтобы представлять $'),

$N

N th лексема

$<name>

Названная лексема

${cmd}

Выведите возвратился, когда MATLAB выполняет команду, cmd

Оператор

Описание

\a

Предупреждение (звуковой сигнал)

\b

Клавиша Backspace

\f

Перевод формата

\n

Новая строка

\r

Возврат каретки

\t

Горизонтальная вкладка

\v

Вертикальная вкладка

\char

Любой символ с особым значением в регулярных выражениях, с которыми вы хотите совпадать буквально (например, используйте \\, чтобы совпадать с одной наклонной чертой влево),

Типы данных: char | cell | string

Поиск или заменяющая опция, заданная как вектор символов или целочисленное значение, как показано в следующей таблице.

Опции появляются в наборы: одна опция, которая соответствует поведению по умолчанию и одной или двум опциям, которые позволяют вам заменять значение по умолчанию. Задайте только одну опцию от набора. Опции могут появиться в любом порядке.

Значение по умолчанию

Переопределение

Описание

'all'

'once'

Совпадайте и заменяйте выражение максимально много раз (значение по умолчанию), или только однажды.

N

Замените только N th вхождение соответствия, где N является целочисленным значением.

'nowarnings'

'warnings'

Отключите предупреждения (значение по умолчанию) или отобразите их.

'matchcase'

'ignorecase'

Совпадайте с регистром (значение по умолчанию) или игнорируйте регистр при соответствии и заменении.

'preservecase'

Игнорируйте регистр при соответствии, но сохраните случай соответствующих символов в исходном тексте в то время как заменяющий.

'noemptymatch'

'emptymatch'

Проигнорируйте нулевые соответствия длины (значение по умолчанию) или включайте их.

'dotall'

'dotexceptnewline'

Точка соответствия с любым символом (значение по умолчанию) или все кроме новой строки (\n).

'stringanchors'

'lineanchors'

Примените ^ и метасимволы $ к началу и концу вектора символов (значение по умолчанию), или к началу и концу строки. Символ новой строки (\n) задает конец строки. Начало строки задано как первый символ или любой символ, который сразу следует за символом новой строки.

'literalspacing'

'freespacing'

Включайте пробелы и комментарии при соответствии (значение по умолчанию), или проигнорируйте их. С freespacing используйте '\ ' и '\#', чтобы совпадать с пробелом и символами #.

Типы данных: char | string

Выходные аргументы

свернуть все

Обновленный текст, возвращенный как вектор символов, массив ячеек из символьных векторов или массив строк. Тип данных newStr совпадает с типом данных str.

Расширенные возможности

Представлено до R2006a

Для просмотра документации необходимо авторизоваться на сайте