printf, fprintf, sprintf, snprintf, printf_s, fprintf_s, sprintf_s, snprintf_s

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

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

int fprintf( FILE          *stream, const char          *format, ... );

int fprintf( FILE *restrict stream, const char *restrict format, ... );

int sprintf( char          *buffer, const char          *format, ... );

int sprintf( char *restrict buffer, const char *restrict format, ... );

int snprintf( char *restrict buffer, size_t bufsz, 
              const char *restrict format, ... );

int printf_s( const char *restrict format, ... );

int fprintf_s( FILE *restrict stream, const char *restrict format, ... );

int sprintf_s( char *restrict buffer, rsize_t bufsz,
               const char *restrict format, ... );

int snprintf_s( char *restrict buffer, rsize_t bufsz,
                const char *restrict format, ... );

Загружает данные из заданных мест, преобразует их в эквиваленты строковых символов и записывает результаты в различные стоки/потоки:

Параметры

Строка format состоит из обычных байтовых символов (кроме %), которые копируются без изменений в выходной поток, и спецификаций преобразования. Каждая спецификация преобразования имеет следующий формат:

• вводящий символ %.
• (необязательно) один или несколько флагов, которые изменяют поведение преобразования:
• -: результат преобразования выравнивается влево в поле (по умолчанию он выравнивается вправо).
• +: знак знакового преобразования всегда предшествует результату преобразования (по умолчанию перед результатом ставится минус только в случае отрицательного значения).
• пробел: если результат знакового преобразования не начинается с символа знака или пустой, пробел добавляется перед результатом. Он игнорируется, если присутствует флаг +.
• #: выполняется альтернативная форма преобразования. См. таблицу ниже для точных эффектов, в противном случае поведение не определено.
• 0: для целых и дробных чисел при преобразовании, ведущие нули используются для заполнения поля вместо символов пробела. Для целых чисел он игнорируется, если точность указана явно. Для других преобразований использование этого флага приводит к неопределённому поведению. Он игнорируется, если присутствует флаг -.
• (необязательно) целое значение или *, которые определяют минимальную ширину поля. Результат дополняется символами пробела (по умолчанию), если необходимо, слева при выравнивании вправо или справа при выравнивании влево. В случае использования *, ширина указывается дополнительным аргументом типа int, который появляется перед аргументом, подлежащим преобразованию, и аргументом, задающим точность, если она задана. Если значение аргумента отрицательно, это приводит к указанию флага - и положительной ширине поля (Примечание: это минимальная ширина: значение никогда не усекается).
• (необязательно) ., за которым следует целое число или *, или ничего, что определяет точность преобразования. В случае использования *, точность указывается дополнительным аргументом типа int, который появляется перед аргументом, подлежащим преобразованию, но после аргумента, задающего минимальную ширину поля, если таковой имеется. Если значение этого аргумента отрицательно, оно игнорируется. Если ни число, ни * не используются, точность принимается равной нулю. См. таблицу ниже для точного эффекта точности.
• (необязательно) модификатор длины, который указывает размер аргумента (в сочетании со спецификатором формата преобразования он указывает тип соответствующего аргумента).
• спецификатор формата преобразования.

Доступны следующие спецификаторы формата:

Функции преобразования чисел с плавающей запятой преобразуют бесконечность в inf или infinity. Какой вариант используется, определяется реализацией.

Не число преобразуется в nan или nan(char_sequence). Какой вариант используется, определяется реализацией.

Преобразования F, E, G, A выдают INF, INFINITY, NAN соответственно.

Несмотря на то, что %c ожидает аргумент int, безопасно передавать аргумент char из-за повышения целого типа, которое происходит при вызове функции с переменным числом аргументов.

Правильные спецификации преобразования для типов символов фиксированной ширины (int8_t, и т. д.) определены в заголовке <inttypes.h> (хотя PRIdMAX, PRIuMAX, и т. д. является синонимом %jd, %ju, и т. д.).

Спецификатор преобразования для записи в память %n является распространенной целью атак с использованием уязвимостей, где формат строки зависит от пользовательского ввода, и не поддерживается семейством функций printf_s с проверкой границ.

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

Если спецификация преобразования недействительна, поведение не определено.

Значение возврата

Примечания

Стандарт C и POSIX указывают, что поведение sprintf и его вариантов не определено, когда аргумент перекрывает буфер назначения. Пример:

sprintf(dst, "%s and %s", dst, t); // <- broken: undefined behavior

POSIX определяет, что errno устанавливается при ошибке. Он также определяет дополнительные спецификации преобразования, в частности, поддержку переупорядочения аргументов (n$ сразу после % указывает на n-й аргумент).

Вызов snprintf с нулевым bufsz и нулевым указателем для buffer полезен для определения необходимого размера буфера для хранения вывода:

const char fmt[] = "sqrt(2) = %f";
int sz = snprintf(NULL, 0, fmt, sqrt(2));
char buf[sz + 1]; // note +1 for terminating null byte
snprintf(buf, sizeof buf, fmt, sqrt(2));

snprintf_s, как и snprintf, но в отличие от sprintf_s, обрезает вывод, чтобы он поместился в bufsz-1.

Пример

#include <stdio.h>
#include <stdint.h>
#include <inttypes.h>
 
int main(void)
{
    const char* s = "Hello";
    printf("Strings:\n"); // same as puts("Strings");
    printf(" padding:\n");
    printf("\t[%10s]\n", s);
    printf("\t[%-10s]\n", s);
    printf("\t[%*s]\n", 10, s);
    printf(" truncating:\n");
    printf("\t%.4s\n", s);
    printf("\t%.*s\n", 3, s);
 
    printf("Characters:\t%c %%\n", 'A');
 
    printf("Integers:\n");
    printf("\tDecimal:\t%i %d %.6i %i %.0i %+i %i\n",
                         1, 2,   3, 0,   0,  4,-4);
    printf("\tHexadecimal:\t%x %x %X %#x\n", 5, 10, 10, 6);
    printf("\tOctal:\t\t%o %#o %#o\n", 10, 10, 4);
 
    printf("Floating point:\n");
    printf("\tRounding:\t%f %.0f %.32f\n", 1.5, 1.5, 1.3);
    printf("\tPadding:\t%05.2f %.2f %5.2f\n", 1.5, 1.5, 1.5);
    printf("\tScientific:\t%E %e\n", 1.5, 1.5);
    printf("\tHexadecimal:\t%a %A\n", 1.5, 1.5);
    printf("\tSpecial values:\t0/0=%g 1/0=%g\n", 0.0/0.0, 1.0/0.0);
 
    printf("Fixed-width types:\n");
    printf("\tLargest 32-bit value is %" PRIu32 " or %#" PRIx32 "\n",
                                     UINT32_MAX,     UINT32_MAX );
}

Strings:
 padding:
        [     Hello]
        [Hello     ]
        [     Hello]
 truncating:
        Hell
        Hel
Characters:        A %
Integers:
        Decimal:        1 2 000003 0  +4 -4
        Hexadecimal:        5 a A 0x6
        Octal:                12 012 04
Floating point:
        Rounding:        1.500000 2 1.30000000000000004440892098500626
        Padding:        01.50 1.50  1.50
        Scientific:        1.500000E+00 1.500000e+00
        Hexadecimal:        0x1.8p+0 0X1.8P+0
        Special values:        0/0=-nan 1/0=inf
Fixed-width types:
        Largest 32-bit value is 4294967295 or 0xffffffff

Ссылки

• Стандарт C17 (ISO/IEC 9899:2018):
• 7.21.6.1 Функция fprintf (стр. 225-230)
• 7.21.6.3 Функция printf (стр. 236)
• 7.21.6.5 Функция snprintf (стр. 237)
• 7.21.6.6 Функция sprintf (стр. 237)
• K.3.5.3.1 Функция fprintf_s (стр. 430)
• K.3.5.3.3 Функция printf_s (стр. 432)
• K.3.5.3.5 Функция snprintf_s (стр. 432-433)
• K.3.5.3.6 Функция sprintf_s (стр. 433)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.21.6.1 Функция fprintf (стр. 309-316)
• 7.21.6.3 Функция printf (стр. 324)
• 7.21.6.5 Функция snprintf (стр. 325)
• 7.21.6.6 Функция sprintf (стр. 325-326)
• K.3.5.3.1 Функция fprintf_s (стр. 591)
• K.3.5.3.3 Функция printf_s (стр. 593-594)
• K.3.5.3.5 Функция snprintf_s (стр. 594-595)
• K.3.5.3.6 Функция sprintf_s (стр. 595-596)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.19.6.1 Функция fprintf (стр. 274-282)
• 7.19.6.3 Функция printf (стр. 290)
• 7.19.6.5 Функция snprintf (стр. 290-291)
• 7.19.6.6 Функция sprintf (стр. 291)
• Стандарт C89/C90 (ISO/IEC 9899:1990):
• 4.9.6.1 Функция fprintf
• 4.9.6.3 Функция printf
• 4.9.6.5 Функция sprintf

См. также