fprintf, _fprintf_l, fwprintf, _fwprintf_l

Artículo
02/19/2013

Imprimir los datos con formato en una secuencia.Versiones más seguras de estas funciones están disponibles; vea 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 ]...
);

Parámetros

stream
puntero a la estructura de FILE .
format
cadena de la Formato-CONTROL.
argument
argumentos opcionales.
locale
la configuración regional a utilizar.

Valor devuelto

fprintf devuelve el número de bytes escritos.fwprintf devuelve el número de caracteres anchos escritos.Cada una de estas funciones devuelve un valor negativo en su lugar a un error de salida aparece.Si stream o format es NULL, estas funciones se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, las funciones devuelven -1 y errno establecido en EINVAL.La cadena de formato no se comprueba si hay caracteres de formato válidos mientras está al utilizar fprintf_s o fwprintf_s.

Vea _doserrno, errno, _sys_errlist, y _sys_nerr para obtener más información al respecto, y otro, códigos de error.

Comentarios

fprintf da formato y imprime una serie de caracteres y valores al resultado stream*.* Cada función argument (si existe) se convierte y salida según la especificación correspondiente de formato en format*.* para fprintf, el argumento de format tiene la misma sintaxis y uso que tiene en printf.

fwprintf es una versión con caracteres anchos de fprintf; en fwprintf, format es una cadena de caracteres.Estas funciones se comportan exactamente igual si la secuencia se abre en el modo de ANSI.fprintf no admite actualmente la salida en una secuencia de UNICODE.

Las versiones de estas funciones con el sufijo de _l son idénticas salvo que utilizan el parámetro locale pasado en lugar de la configuración regional del subproceso actual.

Nota sobre la seguridad
Asegúrese de que format no es una cadena definida por el usuario.

Asignaciones de la rutina de texto genérico

rutina de TCHAR.H	_UNICODE y _MBCS no definido	_MBCS definido	_UNICODE definido
_ftprintf	fprintf	fprintf	fwprintf
_ftprintf_l	_fprintf_l	_fprintf_l	_fwprintf_l

Para obtener más información, vea Especificaciones de formato.

Requisitos

Función	Encabezado necesario
fprintf, _fprintf_l	<stdio.h>
fwprintf, _fwprintf_l	<stdio.h> o <wchar.h>

Para obtener información adicional de compatibilidad, vea compatibilidad en la Introducción.

Ejemplo

// 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" );
}