Spec-Zone.ru › Fish 3.3

printf - вывод текста в соответствии с форматом

Синтаксис

printf FORMAT [ARGUMENT ...]

Описание

printf использует строку формата FORMAT для вывода аргументов ARGUMENT. Это означает, что он принимает спецификаторы формата в строке формата и заменяет каждый из них аргументом.

Аргумент format используется столько раз, сколько необходимо, для преобразования всех заданных аргументов. Таким образом, printf %s\n flounder catfish clownfish shark выведет четыре строки.

В отличие от echo, printf не добавляет новой строки, если она не указана как часть строки.

Он не поддерживает никаких опций, поэтому нет необходимости в разделителе --, что делает его проще использовать для произвольного ввода, чем echo. 1

Спецификаторы формата

Допустимые спецификаторы формата взяты из функции библиотеки C printf(3).

  • %d или %i: Аргумент будет использоваться как целое десятичное число (со знаком или без знака)
  • %o: Восьмеричное беззнаковое целое число
  • %u: Беззнаковое десятичное целое число — это означает, что отрицательные числа будут зацикливаться
  • %x или %X: Беззнаковое шестнадцатеричное целое число
  • %f, %g или %G: Вещественное число. %f по умолчанию имеет 6 знаков после десятичной точки (зависит от локали — например, в de_DE это будет ,). %g и %G будут обрезать хвостовые нули и переключаться на научную запись (как %e) при достаточно малых или больших числах.
  • %e или %E: Вещественное число в научной записи (XXXeYY)
  • %s: Строка
  • %b: Как строка, интерпретирующая обратные слэши, за исключением того, что восьмеричные escapes имеют вид 0 или 0ooo.

%% обозначает буквальный "%".

Преобразование может завершиться ошибкой, например, "102.234" не может без потерь преобразоваться в целое число, что заставит printf вывести ошибку. Если вы готовы потерять информацию, заглушите ошибки с помощью 2>/dev/null.

Число между % и буквой формата задает ширину. Результат будет выравниваться по левому краю пробелами.

Обратные слэши

printf также знает ряд обратных слэшей:

  • \" двойная кавычка
  • \\ обратный слэш
  • \a сигнал (звонок)
  • \b возврат на один символ назад
  • \c не производить дальнейшего вывода
  • \e escape
  • \f перевод страницы
  • \n новая строка
  • \r возврат каретки
  • \t горизонтальная табуляция
  • \v вертикальная табуляция
  • \ooo восьмеричное число (ooo от 1 до 3 цифр)
  • \xhh шестнадцатеричное число (hhh от 1 до 2 цифр)
  • \uhhhh 16-битный символ Unicode (hhhh - 4 цифры)
  • \Uhhhhhhhh 32-битный символ Unicode (hhhhhhhh - 8 цифр)

Ошибки и код возврата

Если заданный аргумент не подходит для заданного формата (например, при попытке преобразовать число 3.141592 в целое число), printf выводит ошибку в stderr. printf также вернёт ненулевое значение, но всё равно попытается вывести как можно больше.

Он также вернёт ненулевое значение, если вообще не было передано аргументов, в этом случае ничего не выведет.

Данный printf импортирован из printf в GNU Coreutils версии 6.9. Если вы хотите использовать более новую версию printf, например, ту, что поставляется с вашей ОС, попробуйте command printf.

Пример

printf '%s\t%s\n' flounder fish

Выведет "flounder fish" (разделенные табуляцией), а затем символ новой строки. Это полезно для написания завершений, так как fish ожидает, что скрипты завершения выведут опцию, за которой следует описание, разделенные табуляцией.

printf '%s: %d' "Number of bananas in my pocket" 42

Выведет "Количество бананов в моём кармане: 42", without и новую строку.

См. также

  • команду echo для более простого вывода

Примечания

1

(на самом деле, хотя echo fish поддерживает --, POSIX запрещает это, поэтому другие реализации не могут быть использованы, если вход содержит что-либо, начинающееся с -).

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

Spec-Zone.ru

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