read - чтение строки ввода в переменные

Резюме

read [OPTIONS] [VARIABLE ...]

Описание

read считывает данные из стандартного ввода и либо записывает результат обратно в стандартный вывод (для использования в подстановке команд), либо сохраняет результат в одной или нескольких оболочечных переменных. По умолчанию read считывает одну строку и разделяет ее на переменные по пробелам или табуляциям. В качестве альтернативы можно использовать нулевой символ или максимальное количество символов для завершения ввода, а также другие разделители. В отличие от других оболочек, нет переменной по умолчанию (например, REPLY) для хранения результата — вместо этого он выводится на стандартный вывод.

Доступны следующие параметры:

-c CMD или --command CMD

Устанавливает начальную строку в буфере команды в интерактивном режиме на CMD.

-d или --delimiter DELIMITER

Разделяет по DELIMITER. DELIMITER будет использоваться как целая строка для разделения, а не набор символов.

-g или --global

Делает переменные глобальными.

-s или --silent

Маскирует символы, написанные на терминале, заменяя их звёздочками. Это полезно для чтения таких данных, как пароли или другая конфиденциальная информация.

-f или --function

Ограничивает область действия переменной текущей выполняемой функцией. Она удаляется при завершении функции.

-l или --local

Ограничивает область действия переменной текущим выполняемым блоком. Она удаляется при завершении блока. Вне блока это эквивалентно --function.

-n или --nchars NCHARS

Заставляет read вернуть результат после считывания NCHARS символов или конца строки, в зависимости от того, что произойдет раньше.

-p или --prompt PROMPT_CMD

Использует вывод оболочечной команды PROMPT_CMD в качестве приглашения в интерактивном режиме. Команда приглашения по умолчанию — set_color green; echo read; set_color normal; echo "> "

-P или --prompt-str PROMPT_STR

Использует PROMPT_STR в качестве приглашения для интерактивного режима. Это эквивалентно echo $PROMPT_STR и предоставляется исключительно для избежания необходимости оформления приглашения в виде команды. Все специальные символы в строке автоматически экранируются перед передачей команде echo.

-R или --right-prompt RIGHT_PROMPT_CMD

Использует вывод оболочечной команды RIGHT_PROMPT_CMD в качестве правого приглашения для интерактивного режима. Команда правого приглашения по умолчанию отсутствует.

-S или --shell

Включает подсветку синтаксиса, автодополнение и завершение команд, подходящие для ввода кода оболочки в интерактивном режиме. ПРИМЕЧАНИЕ: До версии fish 3.0 короткая опция для --shell была -s, но она была изменена для совместимости с короткой опцией -s bash для --silent.

-t - или --tokenize

Принуждает read разделять ввод на переменные по правилам токенизации оболочки. Это означает, что будут учитываться кавычки и экранирование. Этот параметр, конечно, несовместим с другими параметрами управления разделением, такими как --delimiter, и не учитывает IFS (как токенизатор fish). Токены сохраняются так, как они передаются командам в командной строке, поэтому, например, a\ b сохраняется как a b. Обратите внимание, что в настоящее время подстановки команд и скобки остаются без изменений.

-u или --unexport

Запрещает экспорт переменных в дочерние процессы (поведение по умолчанию).

-U или --universal

Делает указанную переменную оболочки универсальной.

-x или --export

Экспортирует переменные в дочерние процессы.

-a или --list

Сохраняет результат как список в одной переменной. Этот параметр также доступен как --array для обратной совместимости.

-z или --null

Помечает конец строки символом NUL вместо новой строки. Это также отключает интерактивный режим.

-L или --line

Считывает каждую строку в последующие переменные и останавливается после заполнения каждой переменной. Этот параметр не может быть объединен с параметром --delimiter.

Без параметра --line, read считывает одну строку ввода из стандартного ввода, разбивает ее на токены и затем присваивает каждый токен каждой переменной, указанной в VARIABLES. Если токенов больше, чем переменных, весь оставшийся текст присваивается последней переменной.

Если не указан параметр для определения способа разделения, как --delimiter, --line или --tokenize, используется переменная IFS в качестве списка символов для разделения. Использование IFS устарело и будет удалено в будущих версиях. Значение по умолчанию для IFS содержит пробелы, табуляции и символы новой строки. В качестве специального случая, если IFS установлено в пустую строку, каждый символ ввода считается отдельным токеном.

С параметром --line, read считывает строку ввода из стандартного ввода в каждую предоставленную переменную, останавливаясь, когда каждая переменная заполнена. Строка не разделятся на токены.

Если имена переменных не указаны, read переходит к специальному случаю, который просто обеспечивает перенаправление из стандартного ввода в стандартный вывод, что полезно для подстановки команд. Например, следующая команда оболочки fish может использоваться для чтения данных, которые должны быть предоставлены в качестве аргумента командной строки из консоли вместо того, чтобы жестко кодировать их в самой команде, что позволяет использовать команду как есть в различных контекстах с различными входными значениями и предотвращает потенциально конфиденциальный текст от включения в историю оболочки:

mysql -uuser -p(read)

При выполнении в этом режиме read не разделяет ввод каким-либо образом и текст перенаправляется в стандартный вывод без дальнейшей обработки или манипулирования.

Если указаны -a или --array, разрешается только одно имя переменной, а токены сохраняются в виде списка в этой переменной.

Дополнительные сведения о правилах области действия переменных см. в документации для set.

Если read достигает конца файла (EOF) вместо терминатора, код выхода устанавливается в 1. В противном случае он устанавливается в 0.

Для защиты оболочки от чрезмерного потребления системных ресурсов, read будет потреблять не более 100 МБ (104857600 байт); если терминатор не будет достигнут до этого предела, то VARIABLE устанавливается в пустую строку, а код выхода устанавливается в 122. Этот предел можно изменить с помощью переменной fish_read_limit. Если она установлена в 0 (ноль), предел удаляется.

Пример

Следующий код сохраняет значение ‘hello’ в оболочечной переменной $foo.

echo hello|read foo

# This is a neat way to handle command output by-line:
printf '%s\n' line1 line2 line3 line4 | while read -l foo
                  echo "This is another line: $foo"
              end

# Delimiters given via "-d" are taken as one string
echo a==b==c | read -d == -l a b c
echo $a # a
echo $b # b
echo $c # c

# --tokenize honors quotes and escaping like the shell's argument passing:
echo 'a\ b' | read -t first second
echo $first # outputs "a b", $second is empty

echo 'a"foo bar"b (command echo wurst)*" "{a,b}' | read -lt -l a b c
echo $a # outputs 'afoo bar' (without the quotes)
echo $b # outputs '(command echo wurst)* {a,b}' (without the quotes)
echo $c # nothing