fprintf, , _fprintf_l_fwprintf_lfwprintf_ftprintf,_ftprintf_l

  • Статья

Печатает форматированные данные в поток. Доступны более безопасные версии этих функций; см. , fwprintf_s_fprintf_s_l, _fwprintf_s_l.fprintf_s

Дополнительные сведения _ftprintf см_ftprintf_l. в сопоставлениях функций универсального текста.

Синтаксис

int fprintf(
   FILE *stream,
   const char *format [,
   argument ]...
);
int _fprintf_l(
   FILE *stream,
   const char *format,
   _locale_t locale [,
   argument ]...
);
int fwprintf(
   FILE *stream,
   const wchar_t *format [,
   argument ]...
);
int _fwprintf_l(
   FILE *stream,
   const wchar_t *format,
   _locale_t locale [,
   argument ]...
);

Параметры

stream
Указатель на структуру FILE .

format
Строка управления форматом.

argument
Необязательные аргументы.

locale
Используемый языковой стандарт.

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

fprintf возвращает число записанных байтов. fwprintf возвращает число записанных расширенных символов. В случае ошибки вывода каждая из этих функций возвращает отрицательное значение. Если stream или format есть NULL, эти функции вызывают обработчик недопустимых параметров, как описано в разделе проверки параметров. Если продолжение выполнения разрешено, функции возвращают значение -1 и задают для errno значение EINVAL. Строка форматирования не проверяется на наличие допустимых символов форматирования, так как она используется fprintf_s или fwprintf_s.

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

Замечания

Функция fprintf форматирует и выводит набор символов и значений в выходной поток stream. Каждый argument функции (при наличии) преобразуется и выводится согласно соответствующей спецификации формата в format. Для fprintfаргумента format имеется тот же синтаксис, что и в printfнем.

fwprintf — версия функции fprintf для расширенных символов; в функции fwprintf параметр format — это строка расширенных символов. Эти функции ведут себя одинаково, если поток открыт в режиме ANSI. Функция fprintf на данный момент не поддерживает вывод данных в поток в кодировке Юникод.

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

Внимание

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

Начиная с Windows 10 версии 2004 (сборка 19041), printf семейство функций выводит точно представленные числа с плавающей запятой в соответствии с правилами IEEE 754 для округления. В предыдущих версиях Windows точно представленные числа с плавающей запятой, заканчивающиеся на "5", всегда округлялись. IEEE 754 утверждает, что они должны округлиться до ближайшей даже цифры (также известной как "Округление банкира"). Например, оба printf("%1.0f", 1.5) и printf("%1.0f", 2.5) должны округлиться до 2. Ранее 1,5 округляет до 2 и 2,5 округления до 3. Это изменение влияет только на точно представленные числа. Например, 2.35 (который при представлении в памяти приближается к 2,3500000000000000008) продолжает округляется до 2,4. Округление, выполняемое этими функциями, теперь также учитывает режим округления с плавающей запятой, заданный fesetround. Ранее округление всегда выбрало FE_TONEAREST поведение. Это изменение влияет только на программы, созданные с помощью Visual Studio 2019 версии 16.2 и более поздних версий. Чтобы использовать устаревшее поведение округления с плавающей запятой, свяжите ссылку с "legacy_stdio_float_rounding.obj".

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

Функция в столбце сопоставляется с функцией в tchar.h других столбцах в зависимости от набора символов, определенного во время компиляции.

Функция tchar.h _UNICODE и _MBCS не определен _MBCS Определенные _UNICODE Определенные
_ftprintf fprintf fprintf fwprintf
_ftprintf_l _fprintf_l _fprintf_l _fwprintf_l

Дополнительные сведения см. в разделе "Синтаксис спецификации формата".

Требования

Function Обязательный заголовок
fprintf, _fprintf_l <stdio.h>
fwprintf, _fwprintf_l <stdio.h> или <wchar.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

// crt_fprintf.c
/* This program uses fprintf to format various
* data and print it to the file named FPRINTF.OUT. It
* then displays FPRINTF.OUT on the screen using the system
* function to invoke the operating-system TYPE command.
*/

#include <stdio.h>
#include <process.h>

FILE *stream;

int main( void )
{
   int    i = 10;
   double fp = 1.5;
   char   s[] = "this is a string";
   char   c = '\n';

   fopen_s( &stream, "fprintf.out", "w" );
   fprintf( stream, "%s%c", s, c );
   fprintf( stream, "%d\n", i );
   fprintf( stream, "%f\n", fp );
   fclose( stream );
   system( "type fprintf.out" );
}

this is a string
10
1.500000

См. также

Потоковый ввод-вывод
_cprintf, , _cprintf_l_cwprintf_cwprintf_l
fscanf, , _fscanf_lfwscanf_fwscanf_l
sprintf, , _sprintf_lswprintf, _swprintf_l_swprintf_l
Синтаксис спецификации форматирования: printf и wprintf функции