Функция библиотеки 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().
Пример
Давайте скомпилируем и запустим приведённую выше программу, которая выдаст следующий результат:
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
В следующем примере выводятся различные форматированные данные:
Пример
Результат выполнения программы:
字符为 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 <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Другие расширения