7.2. Форматный вывод (printf)

Функция printf переводит внутренние значения в текст.

  int printf(char *format, arg1, arg2, ...)

В предыдущих главах мы использовали printf неформально. Здесь мы покажем наиболее типичные случаи применения этой функции; полное ее описание дано в приложении В.

Функция printf преобразует, форматирует и печатает свои аргументы в стандартном выводе под управлением формата. Возвращает она количество напечатанных символов.

Форматная строка содержит два вида объектов: обычные символы, которые напрямую копируются в выходной поток, и спецификации преобразования, каждая из которых вызывает преобразование и печать очередного аргумента printf. Любая спецификация преобразования начинается знаком % и заканчивается символом-спецификатором. Между % и символом-спецификатором могут быть расположены (в указанном ниже порядке) следующие элементы:

• Знак минус, предписывающий выравнивать преобразованный аргумент по левому краю поля.
• Число, специфицирующее минимальную ширину поля. Преобразованный аргумент будет занимать поле по крайней мере указанной ширины. при необходимости лишние позиции слева (или справа при левостороннем расположении) будут заполнены пробелами.
• Точка, отделяющая ширину поля от величины, устанавливающей точность.
• Число (точность), задающее максимальное количество печатаемых символов в строке, или количество цифр после десятичной точки (для чисел с плавающей запятой), или минимальное количество цифр (для целых чисел).
• Буква h, если печатаемое целое должно рассматриваться как short, или l (строчная латинская буква L), если целое должно рассматриваться как long.

Символы-спецификаторы перечислены в таблице 7.1. Если за % не помещен символ-спецификатор, поведение функции printf будет не определено.

Ширину и точность можно задавать с помощью знака *; значение ширины (или точности) в этом случае берется из следующего аргумента, который должен быть типа int. Например, чтобы напечатать не более max символов из строки s, годится следующая запись:

  printf("%.*s", max, s);

Большая часть форматных преобразований была продемонстрирована в предыдущих главах. Исключение составляет задание точности для строк. Далее приводится перечень спецификаций и показывается их влияние на печать строки «hello, world», состоящей из 12 символов. Поле специально обрамлено двоеточиями, чтобы была видна его протяженность.

    %s            :hello, world:
    %10s          :hello, world:
    %.10s         :hello, wor:
    %-10s         :hello, world:
    %.15s         :hello, world:
    %-15s         :hello, world   :
    %15.10s       :     hello, wor:
    %-15.10s      :hello, wor     :

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

  printf(s);        /* НЕВЕРНО, если в s есть % */
  printf("%s", s);  /* ВЕРНО всегда */

Функция sprintf выполняет те же преобразования, что и printf, но вывод запоминается в строке

  int sprintf(char *string, char *format, arg1, arg2, ...)

Эта функция форматирует аргументы arg₁, arg₂ и т.д. в соответствии с информацией, заданной аргументом format, как мы описывали ранее, но результат помещает не в стандартный вывод, а в string. Заметим, что строка string должна быть достаточно большой, чтобы в ней поместился результат.