string-replace - замена подстрок

Синопсис

string replace [(-a | --all)] [(-f | --filter)] [(-i | --ignore-case)] [(-r | --regex)] [(-q | --quiet)] PATTERN REPLACEMENT [STRING...]

Описание

string replace аналогичен string match, но заменяет непересекающиеся совпадающие подстроки строкой-заменителем и выводит результат. По умолчанию PATTERN обрабатывается как буквальная подстрока для сопоставления.

Если заданы -r или --regex, PATTERN интерпретируется как регулярное выражение, совместимое с Perl, а REPLACEMENT может содержать управляющие последовательности в стиле C, такие как \t, а также ссылки на группы захвата по номеру или имени, как $n или ${n}.

Если вы укажете флаг -f или --filter, то каждая входная строка будет выводиться только в том случае, если была произведена замена. Это полезно в тех случаях, когда вы бы иначе использовали этот фрагмент кода: a_cmd | string match pattern | string replace pattern new_pattern. Вместо этого вы можете написать a_cmd | string replace --filter pattern new_pattern.

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

Примеры

Примеры буквальной замены

>_ string replace is was 'blue is my favorite'
blue was my favorite

>_ string replace 3rd last 1st 2nd 3rd
1st
2nd
last

>_ string replace -a ' ' _ 'spaces to underscores'
spaces_to_underscores

Примеры замены с использованием регулярных выражений

>_ string replace -r -a '[^\d.]+' ' ' '0 one two 3.14 four 5x'
0 3.14 5

>_ string replace -r '(\w+)\s+(\w+)' '$2 $1 $$' 'left right'
right left $

>_ string replace -r '\s*newline\s*' '\n' 'put a newline here'
put a
here