fprintf, _fprintf_l, fwprintf, _fwprintf_l

Статья
02/20/2013

Форматированные данные печатью в поток.Более безопасные версии этих функций доступны; см. 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 возвращает число записанных расширенных символов.Каждая из этих функций возвращает отрицательное значение, а не при ошибке вывода.If stream OR format существует NULLэти функции вызываются недопустимый обработчик параметра, как описано в разделе Проверка параметров.Если выполнение может быть продолжено, то функции возвращают -1 и задают errno В EINVAL.Строка форматирования не проверяется для допустимых символов форматирования, так как он при использовании fprintf_s OR fwprintf_s.

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

Заметки

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

fwprintf версия расширенных символов fprintf; IN fwprintf" format строка символов.Эти функции работают одинаково, если поток открыт в режиме ansi-совместимости.fprintf в настоящее время не поддерживает выходные данные в поток в юникоде.

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

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

Сопоставления подпрограммы Родов-Текста

Подпрограмма TCHAR.H	_MBCS не заданные _UNICODE &	Указанный символ _MBCS	Указанный _UNICODE
_ftprintf	fprintf	fprintf	fwprintf
_ftprintf_l	_fprintf_l	_fprintf_l	_fwprintf_l

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

Требования

Функция	Обязательный заголовок
fprintf, _fprintf_l	<stdio.h>
fwprintf, _fwprintf_l	<stdio.h> OR <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" );
}