Spec-Zone.ru › Fish 3.6

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 запрещает это, поэтому другие реализации не могут быть использованы, если вход содержит что-либо, начинающееся с -.

© 2005-2009 Axel Liljencrantz, 2009-2023 fish-shell contributors
Licensed under the GNU General Public License, version 2.
https://fishshell.com/docs/3.6/cmds/printf.html

Spec-Zone.ru

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