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

Резюме

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

Описание

string match проверяет каждое значение СТРОКИ на соответствие ШАБЛОНУ и выводит соответствующие подстроки. Только первое совпадение для каждой СТРОКИ будет отображено, если не указан флаг -a или --all, в этом случае будут отображены все совпадения.

Если вы укажете -e или --entire, то каждая соответствующая строка будет выведена, включая любой префикс или суффикс, не соответствующий шаблону (эквивалентно grep без флага -o). Вы можете, очевидно, достичь того же результата, добавив * или .* в начало и конец шаблона, в зависимости от того, указан ли флаг --regex. Флаг --entire просто позволяет избежать усложнения шаблона таким образом и сделать намерение string match более ясным. Без флагов --entire и --regex ШАБЛОН должен соответствовать всей СТРОКЕ, прежде чем он будет отображен.

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

Если заданы --groups-only или -g, будут отображены только группы захвата — сам полный матч пропустится. Это несовместимо с --entire и --invert, и требует --regex. Это полезно как простой инструмент выделения вместо string replace, поэтому вы можете просто выбрать «эту часть» строки.

Если заданы --index или -n, каждое совпадение отображается как позиция начала (1-основанная) и длина. По умолчанию ШАБЛОН интерпретируется как шаблон glob, сопоставляемый с каждой аргументом СТРОКА целиком. Шаблон glob считается корректным совпадением только если он соответствует всей СТРОКЕ.

Если заданы --regex или -r, ШАБЛОН интерпретируется как регулярное выражение, совместимое с Perl, которое не обязательно должно соответствовать всей СТРОКЕ. Для регулярного выражения, содержащего группы захвата, для каждого совпадения будут отображены несколько элементов: один для всего совпадения и один для каждой группы захвата. В этом случае будет отображена только соответствующая часть СТРОКИ, если не задан флаг --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