Соответствие регулярному выражению (без учета регистра)
возвращает начальный индекс каждой подстроки startIndex = regexpi(str,expression)str соответствует шаблонам символов, указанным регулярным выражением, без учета буквенного регистра. Если нет совпадений, startIndex является пустым массивом.
[ возвращает начальный и конечный индексы всех совпадений.startIndex,endIndex] = regexpi(str,expression)
возвращает выходные данные, указанные out = regexpi(str,expression,outkey)outkey. Например, если outkey является 'match', то regexpi возвращает подстроки, соответствующие выражению, а не их начальным индексам.
[ возвращает выходные данные, определенные несколькими ключевыми словами вывода, в указанном порядке. Например, при указании out1,...,outN] = regexpi(str,expression,outkey1,...,outkeyN)'match','tokens', то regexpi возвращает подстроки, соответствующие всему выражению, и маркеры, соответствующие частям выражения.
___ = regexpi(___,'forceCellOutput') возвращает каждый выходной аргумент в виде скалярной ячейки. Ячейки содержат числовые массивы или подстроки, которые описываются как выходные данные предыдущих синтаксисов. Можно включить любой из входов и запросить любой из выходов из предыдущих синтаксисов.
Найти слова, начинающиеся с c, заканчивается на t, и содержат один или несколько гласных между ними.
str = 'bat cat can car COAT court cut ct CAT-scan'; expression = 'c[aeiou]+t'; startIndex = regexpi(str,expression)
startIndex = 1×4
5 17 28 35
Значения в startIndex укажите индекс первого символа каждого слова, соответствующего регулярному выражению.
Регулярное выражение 'c[aeiou]+t' задает этот шаблон:
c должен быть первым символом.
c за ним должен следовать один из символов внутри скобок, [aeiou].
Узор в скобках должен встречаться один или несколько раз, как указано + оператор.
t должен быть последним символом, без символов между узором в скобках и t.
Совпадение буквенного регистра во всем выражении или его части.
По умолчанию regexpi выполняет сопоставление без учета регистра.
str = 'A character vector with UPPERCASE and lowercase text.'; expression = '\w*case'; matchStr = regexpi(str,expression,'match')
matchStr = 1x2 cell
{'UPPERCASE'} {'lowercase'}
Используйте regexp функция с тем же синтаксисом, что и regexpi для выполнения сопоставления с учетом регистра.
matchWithRegexp = regexp(str,expression,'match')matchWithRegexp = 1x1 cell array
{'lowercase'}
Отключение сопоставления с учетом регистра для regexp, используйте 'ignorecase' вариант.
matchWithIgnorecase = regexp(str,expression,'match','ignorecase')
matchWithIgnorecase = 1x2 cell
{'UPPERCASE'} {'lowercase'}
Для нескольких выражений включите и отключите сопоставление без учета регистра для выбранных выражений с помощью (?i) и (?-i) флаги поиска.
expression = {'(?-i)\w*case';...
'(?i)\w*case'};
matchStr = regexp(str,expression,'match');
celldisp(matchStr)
matchStr{1}{1} =
lowercase
matchStr{2}{1} =
UPPERCASE
matchStr{2}{2} =
lowercase
str - Входной текстВходной текст, заданный как символьный вектор, массив ячеек из символьных векторов или строковый массив. Каждый символьный вектор в массиве ячеек или каждая строка в массиве строк может иметь любую длину и содержать любые символы.
Если str и expression - строковые массивы или массивы ячеек, они должны иметь одинаковые размеры.
Типы данных: string | char | cell
expression - Регулярное выражениеРегулярное выражение, указанное как символьный вектор, массив ячеек из символьных векторов или строковый массив. Каждое выражение может содержать символы, метасимволы, операторы, маркеры и флаги, определяющие шаблоны для сопоставления в str.
В следующих таблицах описаны элементы регулярных выражений.
Метазнаки
Метасимволы представляют собой буквы, диапазоны букв, цифры и символы пробела. Используйте их для построения обобщенного образца символов.
Метахарактер | Описание | Пример |
|---|---|---|
| Любой отдельный символ, включая пробел |
|
| Любой символ, заключенный в квадратные скобки. Следующие символы обрабатываются буквально: |
|
| Любой символ, не заключенный в квадратные скобки. Следующие символы обрабатываются буквально: |
|
| Любой символ в диапазоне |
|
| Любой алфавитный, цифровой или символ подчеркивания. Для английских наборов символов, |
|
| Любой символ, не являющийся алфавитным, цифровым или подчеркиванием. Для английских наборов символов, |
|
| Любой символ пробела; эквивалентно |
|
| Любой символ, отличный от пробела; эквивалентно |
|
| Любая цифровая цифра; эквивалентно |
|
| Любой неигрирующий персонаж; эквивалентно |
|
| Символ восьмеричного значения |
|
| Символ шестнадцатеричного значения |
|
Символьное представление
Оператор | Описание |
|---|---|
| Аварийный сигнал (звуковой сигнал) |
| Клавиша Backspace |
| Веб-канал формы |
| Новая линия |
| Возврат каретки |
| Горизонтальная вкладка |
| Вертикальная вкладка |
| Любой символ со специальным значением в регулярных выражениях, которые должны совпадать буквально (например, используйте |
Кванторы
Квантификаторы указывают, сколько раз шаблон должен присутствовать в соответствующем тексте.
Квантор | Число выполнений выражения | Пример |
|---|---|---|
| 0 или более раз последовательно. |
|
| 0 раз или 1 раз. |
|
| 1 или более раз последовательно. |
|
| По крайней мере
|
|
| По крайней мере
|
|
| Точно Эквивалентно |
|
Квантователи могут появляться в трех режимах, описанных в следующей таблице. q представляет любой из количественных показателей в предыдущей таблице.
Способ | Описание | Пример |
|---|---|---|
| Жадное выражение: соответствует как можно большему количеству символов. | Учитывая текст |
| Ленивое выражение: соответствует необходимому количеству символов. | Учитывая текст |
| Притяжательное выражение: максимально совпадать, но не повторять какие-либо части текста. | Учитывая текст |
Группирование операторов
Операторы группировки позволяют захватывать маркеры, применять один оператор к нескольким элементам или отключать обратное отслеживание в определенной группе.
Оператор группировки | Описание | Пример |
|---|---|---|
| Группировка элементов выражения и маркеров захвата. |
|
| Группировать, но не захватывать токены. |
Без группировки, |
| Группировать атомарно. Не выполняйте обратную трассировку внутри группы для завершения сопоставления и не захватывайте токены. |
|
| Выражение соответствия При совпадении с Можно включить |
|
Якоря
Якоря в выражении соответствуют началу или концу входного текста или слова.
Якорь | Соответствует... | Пример |
|---|---|---|
| Начало входного текста. |
|
| Конец входного текста. |
|
| Начало слова. |
|
| Конец слова. |
|
Утверждения Lookaround
Утверждения lookaround ищут шаблоны, которые непосредственно предшествуют предполагаемому соответствию или следуют за ним, но не являются его частью.
Указатель остается в текущем местоположении, а символы соответствуют test выражения не захватываются и не отбрасываются. Поэтому утверждения lookahead могут совпадать с перекрывающимися группами символов.
Lookaround утверждение | Описание | Пример |
|---|---|---|
| Загляните вперед, чтобы найти совпадающие символы |
|
| Загляните вперед для символов, которые не совпадают |
|
| Искать совпадающие символы |
|
| Искать символы, которые не совпадают |
|
Если перед выражением указать утверждение lookahead, операция эквивалентна логической AND.
Операция | Описание | Пример |
|---|---|---|
| Сопоставить оба |
|
| Матч |
|
Логические и условные операторы
Логические и условные операторы позволяют проверить состояние данного условия, а затем использовать результат, чтобы определить, какой шаблон, если он есть, будет соответствовать следующему. Эти операторы поддерживают логические OR, и if или if/else условия.
Условия могут быть маркерами, операторами поиска или динамическими выражениями формы (?@cmd). Динамические выражения должны возвращать логическое или числовое значение.
Условный оператор | Описание | Пример |
|---|---|---|
| Выражение соответствия При совпадении с |
|
| Если условие |
|
| Если условие |
|
Операторы маркеров
Маркеры - это части совпадающего текста, определяемые путем включения части регулярного выражения в круглые скобки. Можно ссылаться на маркер по его последовательности в тексте (порядковый маркер) или назначать имена маркерам для упрощения обслуживания кода и удобочитаемого вывода.
Оператор маркера порядкового номера | Описание | Пример |
|---|---|---|
| Зафиксируйте в маркере символы, соответствующие заключенному выражению. |
|
| Сопоставить |
|
| Если |
|
Оператор именованного маркера | Описание | Пример |
|---|---|---|
| Зафиксируйте в именованном маркере символы, соответствующие заключенному выражению. |
|
| Сопоставить маркер, на который ссылается |
|
| Если именованный токен найден, тогда сопоставьте |
|
Примечание
Если выражение имеет вложенные круглые скобки, MATLAB ® захватывает маркеры, соответствующие самому внешнему набору круглых скобок. Например, учитывая шаблон поиска'(and(y|rew))', MATLAB создает маркер для 'andrew' но не для 'y' или 'rew'.
Динамические регулярные выражения
Динамические выражения позволяют выполнять команду MATLAB или регулярное выражение для определения совпадающего текста.
Круглые скобки, содержащие динамические выражения, не создают группу захвата.
Оператор | Описание | Пример |
|---|---|---|
| Разбор При анализе |
|
| Выполните команду MATLAB, представленную |
|
| Выполните команду MATLAB, представленную |
|
В динамических выражениях используйте следующие операторы для определения текста замены.
Оператор замены | Описание |
|---|---|
| Часть входного текста, которая в настоящее время соответствует |
| Часть входного текста, предшествующая текущему совпадению |
| Часть входного текста, которая следует за текущим совпадением (используйте |
|
|
| Именованный токен |
| Выходные данные, возвращаемые при выполнении команды MATLAB, |
Комментарии
Персонажи | Описание | Пример |
|---|---|---|
(?#comment) | Вставка комментария в регулярное выражение. Текст комментария игнорируется при совпадении ввода. |
|
Флаги поиска
Флаги поиска изменяют поведение соответствующих выражений. Альтернативой использованию флага поиска в выражении является передача option входной аргумент.
Флаг | Описание |
|---|---|
(?-i) | Совпадение буквенного регистра (по умолчанию для |
(?i) | Не соответствовать буквенному регистру (по умолчанию для |
(?s) | Точка совпадения ( |
(?-s) | Сопоставьте точку в шаблоне с любым символом, который не является символом новой строки. |
(?-m) | Сопоставить |
(?m) | Сопоставить |
(?-x) | Включать символы пробела и комментарии при совпадении (по умолчанию). |
(?x) | Игнорировать символы пробела и комментарии при сопоставлении. Использовать |
Выражение, которое изменяет флаг, может появиться после скобок, например
(?i)\w*
или внутри скобок и отделены от флага двоеточием (:), например,
(?i:\w*)
Последний синтаксис позволяет изменить поведение части большего выражения.
Типы данных: char | cell | string
outkey - Ключевое слово, указывающее, какие выходы возвращать'start' (по умолчанию) | 'end' | 'tokenExtents' | 'match' | 'tokens' | 'names' | 'split'Ключевое слово, указывающее на возвращаемые выходные данные, указанное как один из следующих векторов символов.
Выходное ключевое слово | Прибыль |
|---|---|
| Стартовые индексы всех совпадений, |
| Конечные индексы всех матчей, |
| Начальный и конечный индексы всех маркеров |
| Текст каждой подстроки, соответствующей шаблону в |
| Текст каждого захваченного маркера в |
| Имя и текст каждого именованного маркера |
| Текст несопоставимых подстрок |
Типы данных: char | string
option - Параметр поиска'once' | 'warnings' | 'matchcase' | 'emptymatch' | 'dotexceptnewline' | 'lineanchors' | ...Параметр поиска, заданный как символьный вектор. Опции поставляются попарно: одна опция, соответствующая поведению по умолчанию, и одна опция, позволяющая переопределить значение по умолчанию. Укажите только один вариант из пары. Опции могут отображаться в любом порядке.
|
Дефолт |
Отвергнуть |
Описание |
|---|---|---|
|
|
|
Сопоставьте выражение как можно больше раз (по умолчанию) или только один раз. |
|
|
|
Подавление предупреждений (по умолчанию) или их отображение. |
|
|
|
Игнорировать буквенный регистр (по умолчанию) или сопоставлять регистр. |
|
|
|
Игнорировать совпадения нулевой длины (по умолчанию) или включать их. |
|
|
|
Сопоставить точку с любым символом (по умолчанию) или все, кроме новой строки ( |
|
|
| Обратиться |
|
|
|
Включать символы пробела и комментарии при совпадении (по умолчанию) или игнорировать их. С |
Типы данных: char
startIndex - Начальный индекс каждого матчаНачальные индексы каждого совпадения, возвращаемые в виде вектора строки или массива ячеек, следующим образом:
Если str и expression представляют собой оба вектора символов или строковые скаляры, выход - вектор строки (или, если совпадений нет, пустой массив).
Если либо str или expression - клеточный массив символьных векторов или строковый массив, а другой - символьный вектор или строковый скаляр, выход - клеточный массив строковых векторов. Массив выходных ячеек имеет те же размеры, что и входной массив.
Если str и expression оба массива ячеек или строковые массивы должны иметь одинаковые размеры. Выходные данные представляют собой массив ячеек с одинаковыми размерами.
endIndex - Индекс окончания каждого матчаКонечный индекс каждого совпадения, возвращаемый в виде вектора строки или массива ячеек, следующим образом:
Если str и expression представляют собой оба вектора символов или строковые скаляры, выход - вектор строки (или, если совпадений нет, пустой массив).
Если либо str или expression - клеточный массив символьных векторов или строковый массив, а другой - символьный вектор или строковый скаляр, выход - клеточный массив строковых векторов. Массив выходных ячеек имеет те же размеры, что и входной массив.
Если str и expression оба массива ячеек или строковые массивы должны иметь одинаковые размеры. Выходные данные представляют собой массив ячеек с одинаковыми размерами.
out - Информация о спичкахСведения о совпадениях, возвращаемые в виде числового, ячейки, строки или массива структуры. Информация в выходных данных зависит от значения, указанного для outkey, следующим образом.
Выходное ключевое слово | Описание вывода | Тип и размеры выходных данных |
|---|---|---|
| Стартовые индексы совпадений | Для обоих
|
| Конечные индексы совпадений | |
| Начальный и конечный индексы всех маркеров | По умолчанию при возврате всех совпадений:
При указании Если токен ожидается в определенном индексе |
| Текст каждой подстроки, соответствующей шаблону в | По умолчанию при возврате всех совпадений:
При указании |
| Текст каждого захваченного маркера в | По умолчанию при возврате всех совпадений:
При указании Если маркер ожидается в определенном индексе, но не найден, то MATLAB возвращает пустое значение для маркера, |
| Имя и текст каждого именованного маркера | Для всех матчей:
|
| Текст несопоставимых подстрок | Для всех матчей:
|
Маркеры - это части сопоставленного текста, которые соответствуют частям регулярного выражения. Чтобы создать маркеры, заключите часть регулярного выражения в скобки.
Например, это выражение находит дату формы dd-mmm-yyyy, включая маркеры для дня, месяца и года.
str = 'Here is a date: 01-Apr-2020'; expression = '(\d+)-(\w+)-(\d+)'; mydate = regexp(str,expression,'tokens'); mydate{:}
ans =
1×3 cell array
{'01'} {'Apr'} {'2020'}
Имена можно связать с маркерами, чтобы их было легче идентифицировать:
str = 'Here is a date: 01-Apr-2020'; expression = '(?<day>\d+)-(?<month>\w+)-(?<year>\d+)'; mydate = regexp(str,expression,'names')
mydate =
struct with fields:
day: '01'
month: 'Apr'
year: '2020'
Дополнительные сведения см. в разделе Маркеры в регулярных выражениях.
contains | regexp | regexprep | regexptranslate | replace | strfind | strjoin | strrep | strsplit
Имеется измененная версия этого примера. Открыть этот пример с помощью изменений?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.