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