printf, _printf_l, wprintf, _wprintf_l

Статья
04/10/2013

Печать форматированного результата в стандартный поток вывода.Существуют более безопасные версии этих функций; см. раздел printf_s, _printf_s_l, wprintf_s, _wprintf_s_l.

int printf(
   const char *format [,
   argument]... 
);
int _printf_l(
   const char *format,
   locale_t locale [,
   argument]... 
);
int wprintf(
   const wchar_t *format [,
   argument]... 
);
int _wprintf_l(
   const wchar_t *format,
   locale_t locale [,
   argument]... 
);

Параметры

format
Управление форматом.
argument
Необязательные аргументы.
locale
Используемый языковой стандарт.

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

Возвращает количество напечатанных символов или отрицательное значение в случае ошибки.Если format имеет значение NULL, то обработчик вызывается недопустимого параметра, как описано в разделе Проверка параметров.Если продолжение выполнения разрешено, функция возвращает -1 и устанавливает errno в значение EINVAL.Если EOF (0xFFFF) обнаруживается в argument, функция возвращает -1.

Дополнительные сведения о errno и кодах ошибок см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.

Заметки

Функция printf форматирует и выводит ряд символов и значений в стандартный поток вывода, stdout.Если аргументы определяют строку format, строка format должна содержать спецификации, определяющие формат вывода для аргументов.поведение printf и fprintf, идентичны за исключением того, что printf записывает вывод в stdout, а не в целевое типа FILE.

wprintf — юникодовая версия printf; format — строка юникода.Поведение wprintf и printf идентично, если поток открыт в режиме ANSI-совместимости.printf не поддерживает выходные данные в поток ЮНИКОДАА.

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

Универсальное текстовое сопоставление функций

Функция TCHAR.H	неопределенные _UNICODE & _MBCS	определенные _MBCS	Определение _UNICODE
_tprintf	printf	printf	wprintf

Аргумент format состоит из обычных символов, escape-последовательностей и (если аргументы придерживаются format) спецификаций формата.Обычные символы и escape-последовательности копируются в stdout в порядке их появления.Например, линия:

printf("Line one\n\t\tLine two\n");

создает выходные данные.

Line one
        Line two

Спецификации формата всегда начинается со знака процента (%) и читаются слева направо.При обнаружении printf первой спецификации формата (если таковые имеются), она преобразует значение первого аргумента после format и выводит его соответствующим образом.Вторая спецификация формата соответствует преобразованию и выводу второго аргумента и так далее.Если аргументов больше, чем спецификаций формата, дополнительные аргументы игнорируются.Результаты не определены, если недостаточно аргументов для всех спецификаций формата.

Примечание по безопасности
Убедитесь, что format не является строкой, определяемой пользователем.

Универсальное текстовое сопоставление функций

Подпрограмма TCHAR.H	Не указаны _UNICODE и _MBCS	определенные _MBCS	Определение _UNICODE
_tprintf	printf	printf	wprintf
_tprintf_l	_printf_l	_printf_l	_wprintf_l

Требования

Функция	Требуемый заголовок
printf, _printf_l	<stdio.h>
wprintf, _wprintf_l	<stdio.h> или <wchar.h>

Консоль не поддерживается в приложениях Магазина Windows.Стандартные дескрипторы потока, связанные с консолью, stdin, stdout и stderr, необходимо перенаправить до функции C времени выполнения могут использовать их в приложениях Магазина Windows.Дополнительные сведения о совместимости см. в разделе Совместимость во введении.

Пример

// crt_printf.c
// This program uses the printf and wprintf functions
// to produce formatted output.

#include <stdio.h>

int main( void )
{
   char     ch = 'h', 
            *string = "computer";
   wchar_t  wch = L'w', 
            *wstring = L"Unicode";
   int      count = -9234;
   double   fp = 251.7366;

   // Display integers
   printf( "Integer formats:\n"
           "   Decimal: %d  Justified: %.6d  "
           "Unsigned: %u\n",
           count, count, count, count );

   // Display decimals
   printf( "Decimal %d as:\n   Hex: %Xh  "
           "C hex: 0x%x  Octal: %o\n",
            count, count, count, count );

   // Display in different radixes
   printf( "Digits 10 equal:\n   Hex: %i  "
           "Octal: %i  Decimal: %i\n",
            0x10, 010, 10 );

   // Display characters
   printf("Characters in field (1):\n"
          "%10c%5hc%5C%5lc\n",
          ch, ch, wch, wch);
   wprintf(L"Characters in field (2):\n"
           L"%10C%5hc%5c%5lc\n",
           ch, ch, wch, wch);

   // Display strings
   printf("Strings in field (1):\n%25s\n"
          "%25.4hs\n   %S%25.3ls\n",
          string, string, wstring, wstring);
   wprintf(L"Strings in field (2):\n%25S\n"
           L"%25.4hs\n   %s%25.3ls\n",
           string, string, wstring, wstring);

   // Display real numbers
   printf("Real numbers:\n   %f %.2f %e %E\n",
          fp, fp, fp, fp );

   // Display pointer
   printf( "\nAddress as:   %p\n", &count);
}

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

Integer formats:
   Decimal: -9234  Justified: -009234  Unsigned: 4294958062
Decimal -9234 as:
   Hex: FFFFDBEEh  C hex: 0xffffdbee  Octal: 37777755756
Digits 10 equal:
   Hex: 16  Octal: 8  Decimal: 10
Characters in field (1):
         h    h    w    w
Characters in field (2):
         h    h    w    w
Strings in field (1):
                 computer
                     comp
   Unicode                      Uni
Strings in field (2):
                 computer
                     comp
   Unicode                      Uni
Real numbers:
   251.736600 251.74 2.517366e+002 2.517366E+002

Address as:   0012FF3C