Spec-Zone.ru › Fish 3.3

string-split - разделение строк по разделителю

Синопсис

string split [(-f | --fields) FIELDS] [(-m | --max) MAX] [(-n | --no-empty)] [(-q | --quiet)] [(-r | --right)] SEP [STRING...]
string split0 [(-f | --fields) FIELDS] [(-m | --max) MAX] [(-n | --no-empty)] [(-q | --quiet)] [(-r | --right)] [STRING...]

Описание

string split разбивает каждую строку STRING по разделителю SEP, который может быть пустой строкой. Если -m или --max указаны, то выполняется не более MAX разделений для каждой строки STRING. Если -r или --right заданы, разделение выполняется справа налево. Это полезно в сочетании с -m или --max. С -n или --no-empty, пустые результаты исключаются из рассмотрения (например, hello\n\nworld расширяется до двух строк, а не трёх). Код возвращает 0, если было выполнено хотя бы одно разделение, или 1 в противном случае.

Используйте -f или --fields для вывода определённых полей. Если не используется --allow-empty, в случае отсутствия заданного поля команда завершается с кодом 1 и не выводит ничего.

См. также опцию --delimiter команды read.

string split0 разбивает каждую строку STRING по нулевому байту (NUL). Опции аналогичны string split, за исключением того, что разделитель не задаётся.

split0 обладает важным свойством: его вывод не разделяется далее при использовании в подстановке команд, что позволяет подстановке команд генерировать элементы, содержащие символы новой строки. Это особенно полезно при работе с утилитами Unix, которые производят нулевые байты, такими как find -print0 или sort -z. Смотрите примеры split0 ниже.

Примеры

>_ string split . example.com
example
com

>_ string split -r -m1 / /usr/local/bin/fish
/usr/local/bin
fish

>_ string split '' abc
a
b
c

>_ string split --allow-empty -f1,3,5 '' abc
a
c

Примеры с разделителем NUL

>_ # Count files in a directory, without being confused by newlines.
>_ count (find . -print0 | string split0)
42

>_ # Sort a list of elements which may contain newlines
>_ set foo beta alpha\ngamma
>_ set foo (string join0 $foo | sort -z | string split0)
>_ string escape $foo[1]
alpha\ngamma

© 2021 fish-shell developers
Licensed under the GNU General Public License, version 2.
https://fishshell.com/docs/3.3/cmds/string-split.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API