string-match - поиск подстрок

Синопсис

string match [(-a | --all)] [(-e | --entire)] [(-i | --ignore-case)] [(-r | --regex)] [(-n | --index)] [(-q | --quiet)] [(-v | --invert)] PATTERN [STRING...]

Описание

string match проверяет каждую строку STRING относительно шаблона PATTERN и выводит совпадающие подстроки. Только первое совпадение для каждой строки STRING отображается, если не указано -a или --all, в этом случае отображаются все совпадения.

Если вы укажете -e или --entire, то каждая совпадающая строка будет выводиться, включая любой префикс или суффикс, не соответствующий шаблону (эквивалентно grep без флага -o). Вы, очевидно, можете достичь того же результата, добавив * или .*, в зависимости от того, указан ли флаг --regex. Флаг --entire просто позволяет избежать усложнения шаблона и сделать намерение string match более ясным. Без --entire и --regex, шаблон PATTERN должен соответствовать всей строке STRING, прежде чем он будет отображён.

Сопоставление может быть сделано без учёта регистра с помощью --ignore-case или -i.

Если указаны --index или -n, каждое совпадение отображается как позиция начала с индексом 1 и длина. По умолчанию шаблон PATTERN интерпретируется как шаблон glob, сравниваемый с каждой строкой-аргументом STRING. Шаблон glob считается допустимым совпадением только в том случае, если он соответствует всей строке STRING.

Если указаны --regex или -r, шаблон PATTERN интерпретируется как регулярное выражение, совместимое с Perl, которое не обязательно должно соответствовать всей строке STRING. Для регулярного выражения, содержащего группы захвата, будут отображаться несколько элементов для каждого совпадения: одно для всего совпадения и одно для каждой группы захвата. В этом случае будет отображаться только совпадающая часть строки STRING, если не указан --entire.

При сопоставлении с помощью регулярных выражений, string match автоматически устанавливает переменные для всех именованных групп захвата ((?<name>expression)). Для каждой именованной группы захвата будет создана переменная с именем группы в стандартном пространстве имен, и она будет установлена в значение группы захвата в первом совпавшем аргументе. Если именованная группа захвата совпала с пустой строкой, переменная будет установлена в пустую строку (как set var ""). Если она не совпала, переменная будет установлена в пустое значение (как set var). Если --regex используется с --all, это поведение меняется. Каждая именованная переменная будет содержать список совпадений, при этом первое совпадение будет содержаться в первом элементе, второе совпадение во втором и т.д. Если группа была пустой или не совпала, соответствующий элемент будет пустой строкой.

Если используется --invert или -v, выбранные строки будут только те, которые не соответствуют заданному шаблону glob или регулярному выражению.

Код возврата: 0, если найдено хотя бы одно совпадение, или 1 в противном случае.

Примеры

Примеры сопоставления с шаблонами glob

>_ string match '?' a
a

>_ string match 'a*b' axxb
axxb

>_ string match -i 'a??B' Axxb
Axxb

>_ echo 'ok?' | string match '*\?'
ok?

# Note that only the second STRING will match here.
>_ string match 'foo' 'foo1' 'foo' 'foo2'
foo

>_ string match -e 'foo' 'foo1' 'foo' 'foo2'
foo1
foo
foo2

>_ string match 'foo?' 'foo1' 'foo' 'foo2'
foo1
foo2

Примеры сопоставления с регулярными выражениями

>_ string match -r 'cat|dog|fish' 'nice dog'
dog

>_ string match -r -v "c.*[12]" {cat,dog}(seq 1 4)
dog1
dog2
cat3
dog3
cat4
dog4

>_ string match -r '(\d\d?):(\d\d):(\d\d)' 2:34:56
2:34:56
2
34
56

>_ string match -r '^(\w{2,4})\1$' papa mud murmur
papa
pa
murmur
mur

>_ string match -r -a -n at ratatat
2 2
4 2
6 2

>_ string match -r -i '0x[0-9a-f]{1,8}' 'int magic = 0xBadC0de;'
0xBadC0de

>_ echo $version
3.1.2-1575-ga2ff32d90
>_ string match -rq '(?<major>\d+).(?<minor>\d+).(?<revision>\d+)' -- $version
>_ echo "You are using fish $major!"
You are using fish 3!

>_ string match -raq ' *(?<sentence>[^.!?]+)(?<punctuation>[.!?])?' "hello, friend. goodbye"
>_ printf "%s\n" -- $sentence
hello, friend
goodbye
>_ printf "%s\n" -- $punctuation
.

>_ string match -rq '(?<word>hello)' 'hi'
>_ count $word
0