Функция библиотеки C -printf()

Стандартная библиотека C - <stdio.h>

Описание

Функции библиотеки Cint printf(const char *format, ...)Отправляет форматированный вывод в стандартный вывод stdout.

Формат вызова функции printf() следующий:

printf("<格式化字符串>", <参量表>);

Объявление

Ниже приведено объявление функции printf().

int printf(const char *format, ...)

Параметр

  • format-- Это строка, содержащая текст, который должен быть записан в стандартный вывод stdout. Она может содержать встроенные спецификаторы формата, которые могут быть заменены значениями, указанными в следующих дополнительных аргументах, и отформатированы требуемым образом. Атрибуты спецификатора формата таковы: %[flags][width][.precision][length]specifierПодробное объяснение приведено ниже:

Символ формата Значение
a, A

Выводит числа с плавающей запятой в шестнадцатеричной форме (новое в C99).

Примерprintf("pi=%a\n", 3.14);Выводpi=0x1.91eb86p+1。

d Выводит знаковые целые числа в десятичной форме (без знака для положительных чисел).
o Выводит беззнаковые целые числа в восьмеричной форме (без префикса 0).
x,X Выводит беззнаковые целые числа в шестнадцатеричной форме (без префикса 0x).
u Выводит беззнаковое целое число в десятичной форме
f Выводит вещественные числа одинарной/двойной точности в дробной форме
e,E Выводит вещественные числа одинарной/двойной точности в экспоненциальной форме
g,G Выводит вещественные числа одинарной или двойной точности, используя более короткую ширину вывода из %f или %e.
c Выводит один символ
s Выводит строку
p Выводит адрес указателя
lu 32-битное беззнаковое целое
llu 64-битное беззнаковое целое

флагиОписание
-Выравнивает по левому краю в пределах заданной ширины поля; по умолчанию используется выравнивание по правому краю (см. подспецификатор ширины).
+Принудительно отображает знак плюс или минус (+ или -) перед результатом, т. е. перед положительными числами будет отображаться знак +. По умолчанию знак - отображается только перед отрицательными числами.
пробелЕсли знак не указан, вставьте пробел перед значением.
#При использовании со спецификаторами o, x или X ненулевые значения предваряются соответственно 0, 0x или 0X.
При использовании с e, E и f он заставляет вывод содержать десятичную точку, даже если после неё нет цифр. По умолчанию десятичная точка не отображается, если после неё нет цифр.
При использовании с g или G результат такой же, как при использовании e или E, но конечные нули не удаляются.
0Помещает нули (0) слева от числа для заполнения указанного поля вместо пробелов (см. подспецификатор ширины).

widthОписание
(число)Минимальное количество выводимых символов. Если выходное значение короче этого числа, результат будет дополнен пробелами. Если выходное значение длиннее этого числа, результат не будет усечён.
*Ширина не указывается в строке формата, а передаётся как дополнительный целочисленный аргумент, размещённый перед форматируемым аргументом.

.точностьОписание
.числоДля целочисленных спецификаторов (d, i, o, u, x, X): точность задаёт минимальное количество цифр для записи. Если записываемое значение короче этого числа, результат будет дополнен ведущими нулями. Если записываемое значение длиннее этого числа, результат не будет усечён. Точность 0 означает, что символы не записываются.
Для спецификаторов e, E и f: количество цифр, выводимых после десятичной точки.
Для спецификаторов g и G: максимальное количество выводимых значащих цифр.
Для s: максимальное количество выводимых символов. По умолчанию выводятся все символы до встречи с завершающим нулевым символом.
Для типа c: не оказывает эффекта.
Если точность не указана, значение по умолчанию — 1. Если она указана без явного значения, предполагается, что она равна 0.
.*Точность не указывается в строке формата, а передаётся как дополнительный целочисленный аргумент, размещённый перед форматируемым аргументом.

lengthОписание
hАргумент интерпретируется как короткое целое или беззнаковое короткое целое (применимо только к целочисленным спецификаторам: i, d, o, u, x и X).
lАргумент интерпретируется как длинное целое или беззнаковое длинное целое, применимо к спецификаторам целых чисел (i, d, o, u, x и X) и к спецификаторам c (означает широкий символ) и s (означает строку широких символов).
LАргумент интерпретируется как long double (применимо только к спецификаторам чисел с плавающей запятой: e, E, f, g и G).
  • Дополнительные аргументы-- В зависимости от строки формата функция может требовать ряд дополнительных аргументов, каждый из которых содержит значение для вставки, заменяющее каждый тег %, указанный в аргументе формата. Количество аргументов должно совпадать с количеством тегов %.

Возвращаемое значение

В случае успеха возвращает общее количество записанных символов; в противном случае возвращает отрицательное число.

Пример

В следующем примере демонстрируется использование функции printf().

Пример

#include <stdio.h> int main () { int ch; for( ch = 75 ; ch <= 100; ch++ ) { printf("значение ASCII = %d, символ = %c\n", ch , ch ); } return(0); }

Давайте скомпилируем и запустим приведённую выше программу, которая выдаст следующий результат:

ASCII 值 = 75, 字符 = K
ASCII 值 = 76, 字符 = L
ASCII 值 = 77, 字符 = M
ASCII 值 = 78, 字符 = N
ASCII 值 = 79, 字符 = O
ASCII 值 = 80, 字符 = P
ASCII 值 = 81, 字符 = Q
ASCII 值 = 82, 字符 = R
ASCII 值 = 83, 字符 = S
ASCII 值 = 84, 字符 = T
ASCII 值 = 85, 字符 = U
ASCII 值 = 86, 字符 = V
ASCII 值 = 87, 字符 = W
ASCII 值 = 88, 字符 = X
ASCII 值 = 89, 字符 = Y
ASCII 值 = 90, 字符 = Z
ASCII 值 = 91, 字符 = [
ASCII 值 = 92, 字符 = \
ASCII 值 = 93, 字符 = ]
ASCII 值 = 94, 字符 = ^
ASCII 值 = 95, 字符 = _
ASCII 值 = 96, 字符 = `
ASCII 值 = 97, 字符 = a
ASCII 值 = 98, 字符 = b
ASCII 值 = 99, 字符 = c
ASCII 值 = 100, 字符 = d

В следующем примере выводятся различные форматированные данные:

Пример

#include <stdio.h> int main() { char ch = 'A'; char str[20] = "www.example.com"; float flt = 10.234; int no = 150; double dbl = 20.123456; printf("Символ — %c\n", ch); printf("Строка — %s\n" , str); printf("Число с плавающей запятой — %f\n", flt); printf("Целое число — %d\n" , no); printf("Значение двойной точности — %lf\n", dbl); printf("Восьмеричное значение — %o\n", no); printf("Шестнадцатеричное значение — %x\n", no); return 0; }

Результат выполнения программы:

字符为 A 
字符串为 www.example.com 
浮点数为 10.234000 
整数为 150
双精度值为 20.123456 
八进制值为 226 
十六进制值为 96 

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

  • %dДесятичное целое число со знаком
  • %uБеззнаковое десятичное целое
  • %fЧисло с плавающей запятой
  • %sString
  • %cОдиночный символ
  • %pЗначение указателя
  • %eЧисло с плавающей запятой в экспоненциальной форме
  • %x, %XБеззнаковое целое, представленное в шестнадцатеричной форме
  • %oБеззнаковое целое, представленное в восьмеричной форме
  • %gВывести значение, используя формат (%e или %f), который даёт более короткую длину вывода.
  • %pСпецификатор вывода адреса
  • %lu32-разрядное беззнаковое целое
  • %llu64-разрядное беззнаковое целое
  • %%Выводит сам символ знака процента.

Помимо спецификаторов формата, функция printf() также поддерживает флаги и параметры для управления точностью вывода, шириной, символами заполнения, выравниванием и т. д. Например:

  • %-10s: строка, выровненная по левому краю, занимающая ширину 10;
  • %5.2f: число с плавающей запятой, выровненное по правому краю, занимающее ширину 5, с двумя знаками после запятой;
  • %#x: вывести шестнадцатеричное число с префиксом 0x.

Функция printf() также поддерживает списки аргументов переменной длины, которые можно обозначать многоточием...для указания нескольких значений для вывода. Внутри функции макросы va_start() и va_end() можно использовать для доступа к значениям в списке аргументов переменной длины. Например:

Пример

#include <stdio.h>
#include <stdarg.h>

void print_values(int count, ...)
{
    va_list args;
    va_start(args, count);
    for (int i = 0; i < count; i++) {
        printf("%d ", va_arg(args, int));
    }
    va_end(args);
}

int main()
{
    print_values(3, 1, 2, 3); // вывод "1 2 3"
    return 0;
}

Результат выполнения программы:

1 2 3

Стандартная библиотека C - <stdio.h>

Другие расширения