fprintf, _fprintf_l, fwprintf, _fwprintf_l

Статья
06/09/2015

Печатает форматированные данные в поток. Существуют более безопасные версии этих функций; см. раздел fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_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.

См. раздел _doserrno, errno, _sys_errlist, and _sys_nerr для дополнительных сведений по этим и другим кодам возврата.

Заметки

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

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

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

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

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

Подпрограмма TCHAR.H	_UNICODE & _MBCS не определены	_MBCS определено	_UNICODE определено
_ftprintf	fprintf	fprintf	fwprintf
_ftprintf_l	_fprintf_l	_fprintf_l	_fwprintf_l

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

Требования

Функция	Обязательный заголовок
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" );
}