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

Выведет “Number of bananas in my pocket: 42”, without новую строку.

См. также

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

Примечания

1

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