Compartir a través de


fprintf, _fprintf_l, fwprintf, _fwprintf_l

Datos con formato imprime en una secuencia. Hay disponibles versiones más seguras de estas funciones; 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 FILE.

  • format
    Cadena de control de formato.

  • argument
    Argumentos opcionales.

  • locale
    Configuración regional que se va a usar.

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 establecen errno 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 sobre estos y otros 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 igual si el flujo se abre en modo ANSI. fprintf no admite actualmente la salida a un flujo UNICODE.

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

Nota de seguridadNota sobre la seguridad

Asegúrese de que format no es una cadena definida por el usuario.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H

_UNICODE y _MBCS no definidos

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

Equivalente en .NET Framework

System::IO::StreamWriter::Write

Vea también

Referencia

E/S de secuencia

_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

fscanf, _fscanf_l, fwscanf, _fwscanf_l

sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l

Sintaxis de especificación de formato: Funciones printf y wprintf