string-match - соответствие подстрокам

Краткое описание

string match [-a | --all] [-e | --entire] [-i | --ignore-case]
             [-g | --groups-only] [-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 в противном случае.

Примеры

>_ 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