fprintf, _fprintf_l, fwprintf, _fwprintf_lfprintf, _fprintf_l, fwprintf, _fwprintf_l

Imprima datos con formato en una secuencia.Print formatted data to a stream. Hay disponibles versiones más seguras de estas funciones; consulte fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.More secure versions of these functions are available; see fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l.

SintaxisSyntax

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ámetrosParameters

misionesstream
Puntero a la estructura FILE.Pointer to FILE structure.

formatformat
Cadena de control de formato.Format-control string.

argumentargument
Argumentos opcionales.Optional arguments.

localelocale
Configuración regional que se va a usar.The locale to use.

Valor devueltoReturn Value

fprintf devuelve el número de bytes escritos.fprintf returns the number of bytes written. fwprintf devuelve el número de caracteres anchos escritos.fwprintf returns the number of wide characters written. Cada una de estas funciones devuelve un valor negativo cuando se produce un error de salida.Each of these functions returns a negative value instead when an output error occurs. Si Stream o Format es null, estas funciones invocan el controlador de parámetros no válidos, tal y como se describe en validación de parámetros.If stream or format is NULL, these functions invoke the invalid parameter handler, as described in Parameter Validation. Si la ejecución puede continuar, las funciones devuelven-1 y establecen errno en EINVAL.If execution is allowed to continue, the functions return -1 and set errno to EINVAL. No se comprueba la cadena de formato para los caracteres de formato válidos, ya que se usa fprintf_s o fwprintf_s.The format string is not checked for valid formatting characters as it is when using fprintf_s or fwprintf_s.

Consulte _doserrno, errno, _sys_errlist y _sys_nerr para obtener más información sobre estos y otros códigos de error.See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, error codes.

ObservacionesRemarks

fprintf da formato e imprime una serie de caracteres y valores en el flujo de salida.fprintf formats and prints a series of characters and values to the output stream. Cada argumento de función (si existe) se convierte y se genera de acuerdo con la especificación de formato correspondiente en el formato.Each function argument (if any) is converted and output according to the corresponding format specification in format. Para fprintf, el argumento de formato tiene la misma sintaxis y se usa en printf.For fprintf, the format argument has the same syntax and use that it has in printf.

fwprintf es una versión con caracteres anchos de fprintf; en fwprintf, Format es una cadena de caracteres anchos.fwprintf is a wide-character version of fprintf; in fwprintf, format is a wide-character string. Estas funciones se comportan igual si el flujo se abre en modo ANSI.These functions behave identically if the stream is opened in ANSI mode. fprintf no admite actualmente la salida en un flujo Unicode.fprintf does not currently support output into a UNICODE stream.

Las versiones de estas funciones con el sufijo _L son idénticas, salvo que utilizan el parámetro de configuración regional que se pasa en lugar de la configuración regional del subproceso actual.The versions of these functions with the _l suffix are identical except that they use the locale parameter passed in instead of the current thread locale.

Importante

Asegúrese de que format no es una cadena definida por el usuario.Ensure that format is not a user-defined string.

Asignaciones de rutina de texto genéricoGeneric-Text Routine Mappings

Rutina TCHAR.HTCHAR.H routine _UNICODE y _MBCS no definidos_UNICODE & _MBCS not defined _MBCS definido_MBCS defined _UNICODE definido_UNICODE defined
_ftprintf_ftprintf fprintffprintf fprintffprintf fwprintffwprintf
_ftprintf_l_ftprintf_l _fprintf_l_fprintf_l _fprintf_l_fprintf_l _fwprintf_l_fwprintf_l

Para obtener más información, vea Especificaciones de formato.For more information, see Format Specifications.

RequisitosRequirements

FunciónFunction Encabezado necesarioRequired header
fprintf, _fprintf_lfprintf, _fprintf_l <stdio.h>
fwprintf, _fwprintf_lfwprintf, _fwprintf_l <stdio.h> o <wchar.h><stdio.h> or <wchar.h>

Para obtener información adicional sobre compatibilidad, consulte Compatibilidad.For additional compatibility information, see Compatibility.

EjemploExample

// 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

Consulte tambiénSee also

E/S de secuenciaStream I/O
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fscanf, _fscanf_l, fwscanf, _fwscanf_lfscanf, _fscanf_l, fwscanf, _fwscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, _ _swprintf_lsprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
Sintaxis de especificación de formato: funciones printf y wprintfFormat Specification Syntax: printf and wprintf Functions