Compartir a través de


E/S de secuencia

Estas funciones procesan datos de diferentes tamaños y formatos, desde caracteres individuales a estructuras de datos de gran tamaño. También proporcionan almacenamiento en búfer, que puede mejorar el rendimiento. El tamaño predeterminado de un búfer de secuencia es 4K. Estas rutinas afectan sólo a los búferes creados por las rutinas de biblioteca en tiempo de ejecución y no tienen ningún efecto en los búferes creados por el sistema operativo.

Rutinas de E/S de flujo

Routine Usar
clearerr, clearerr_s Indicador de borrar error para la secuencia
fclose Cerrar secuencia
_fcloseall Cerrar todas las secuencias abiertas excepto stdin, stdouty stderr
_fdopen, wfdopen Asociar la secuencia con un descriptor de archivo del archivo abierto
feof Prueba de fin de archivo en secuencia
ferror Prueba de error en secuencia
fflush Vaciar la secuencia en el búfer o en el dispositivo de almacenamiento
fgetc, fgetwc Leer carácter de la secuencia (versiones de función de getc y getwc)
_fgetchar, _fgetwchar Leer carácter de stdin (versiones de función de getchar y getwchar)
fgetpos Obtener el indicador de posición de la secuencia
fgets, fgetws Leer cadena de la secuencia
_fileno Obtener el descriptor de archivo asociado con la secuencia
_flushall Vaciar todas las secuencias en el búfer o en el dispositivo de almacenamiento
fopen, _wfopen, , fopen_s,_wfopen_s Abrir secuencia
fprintf, _fprintf_l, fwprintf, _fwprintf_l, fprintf_s, _fprintf_s_l, , fwprintf_s_fwprintf_s_l Escribe datos con formato en la secuencia
fputc, fputwc Escribir un carácter en una secuencia (versiones de función de putc y putwc)
_fputchar, _fputwchar Escribir un carácter en stdout (versiones de función de putchar y putwchar)
fputs, fputws Escribir cadena en la secuencia
fread Leer datos sin formato de la secuencia
freopen, _wfreopen, , freopen_s,_wfreopen_s Reasignar el puntero de la secuencia FILE al nuevo archivo o dispositivo
fscanf, fwscanf, fscanf_s, _fscanf_s_l, , fwscanf_s, _fwscanf_s_l Leer datos con formato de la secuencia
fseek, _fseeki64 Mover posición de archivo a la ubicación dada
fsetpos Establecer el indicador de posición de la secuencia
_fsopen, _wfsopen Abre una secuencia con uso compartido de archivos.
ftell, _ftelli64 Obtener la posición del archivo actual
fwrite Escribir elementos de datos sin formato en la secuencia
getc, getwc Leer carácter de la secuencia (versiones de macro de fgetc y fgetwc)
getchar, getwchar Leer caracteres de stdin (versiones de macro de fgetchar y fgetwchar)
_getmaxstdio Devuelve el número de archivos que se permite abrir simultáneamente en el nivel de E/S de secuencia.
gets_s, _getws_s Leer línea de stdin
_getw Leer int binario de la secuencia
printf, _printf_l, wprintf, _wprintf_l,printf_s_printf_s_l , , , wprintf_s_wprintf_s_l Escribir datos con formato en stdout
putc, putwc Escribir carácter en una secuencia (versiones de macro de fputc y fputwc)
putchar, putwchar Escribir carácter en stdout (versiones de macro de fputchar y fputwchar)
puts, _putws Escribir línea en la secuencia
_putw Escribir int binario en la secuencia
rewind Mover la posición de archivo al principio de la secuencia
_rmtmp Quitar archivos temporales creados por tmpfile
scanf, _scanf_l, wscanf, _wscanf_l,scanf_s_scanf_s_l , , , wscanf_s_wscanf_s_l Leer datos con formato de stdin
setbuf Controlar el almacenamiento en búfer de la secuencia
_setmaxstdio Establece el número de archivos que se permite abrir simultáneamente en el nivel de E/S de secuencia.
setvbuf Controlar el almacenamiento en búfer de la secuencia y el tamaño del búfer
_snprintf, _snwprintf, _snprintf_s, _snprintf_s_l, , _snwprintf_s, _snwprintf_s_l Escribir datos con formato de la longitud especificada en la cadena
_snscanf, _snwscanf, _snscanf_s, _snscanf_s_l, , _snwscanf_s, _snwscanf_s_l Lee los datos con formato de una longitud especificada del flujo de entrada estándar.
sprintf, swprintf, sprintf_s, _sprintf_s_l, , swprintf_s, _swprintf_s_l Escribir datos con formato en cadena
sscanf, swscanf, sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l Leer datos con formato de la cadena
_tempnam, _wtempnam Generar un nombre de archivo temporal en el directorio dado
tmpfile, tmpfile_s Crear un archivo temporal
tmpnam, _wtmpnam, , tmpnam_s,_wtmpnam_s Generar un nombre de archivo temporal
ungetc, ungetwc Insertar el carácter de nuevo en la secuencia
_vcprintf, _vcwprintf, _vcprintf_s, _vcprintf_s_l, , _vcwprintf_s, _vcwprintf_s_l Escribir datos con formato en la consola.
vfprintf, vfwprintf, vfprintf_s, _vfprintf_s_l, , vfwprintf_s, _vfwprintf_s_l Escribe datos con formato en la secuencia
vprintf, vwprintf, vprintf_s, _vprintf_s_l, , vwprintf_s, _vwprintf_s_l Escribir datos con formato en stdout
_vsnprintf, _vsnwprintf, vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, , _vsnwprintf_s_vsnwprintf_s_l Escribir datos con formato de la longitud especificada en el búfer
vsprintf, vswprintf, vsprintf_s, _vsprintf_s_l, , vswprintf_s, _vswprintf_s_l Escribir datos con formato en el búfer

Cuando un programa inicia la ejecución, el código de inicio abre automáticamente varias secuencias: entrada estándar (señalada por stdin), salida estándar (señalada por stdout) y errores estándar (señalada por stderr). Estas secuencias se dirigen a la consola (teclado y pantalla) de forma predeterminada. Utilice freopen para redirigir stdin, stdouto stderr a un archivo de disco o un dispositivo.

Los archivos abiertos con las rutinas de secuencia se almacenan en búfer de forma predeterminada. Las stdout funciones y stderr se vacían siempre que estén llenas o, si está escribiendo en un dispositivo de caracteres, después de cada llamada de biblioteca. Si un programa finaliza incorrectamente, los búferes de salida pueden no ser vaciados, lo que resulta en pérdida de datos. Use fflush o _flushall para asegurarse de que el búfer asociado a un archivo especificado se vacía en el sistema operativo o que se vacían todos los búferes abiertos. El sistema operativo puede almacenar en caché los datos antes de escribirlos en el disco. La característica de confirmación en disco garantiza que el contenido del búfer vaciado no se pierda si se produce un error del sistema.

Hay dos formas de confirmar el contenido del búfer en el disco:

  • Vincular con el archivo COMMODE.OBJ para establecer una un indicador global de confirmación. El valor predeterminado del indicador global es npara "no-commit".

  • Establezca el indicador de modo en c con fopen o _fdopen.

Cualquier archivo que se abra específicamente con el indicador c o n se comporta según el indicador, independientemente del estado del indicador global commit/no-commit.

Si el programa no cierra explícitamente una secuencia, la secuencia se cierra automáticamente cuando finaliza el programa. Sin embargo, debe cerrar una secuencia cuando el programa termina de usarla, ya que el número de secuencias que pueden estar abiertas al mismo tiempo es limitado. Consulte _setmaxstdio para obtener información sobre este límite.

La entrada puede seguir directamente a la salida sólo con una llamada intermedia a fflush o a una función de posicionamiento de archivo (fseek, fsetposo rewind). La entrada puede ir seguida de una salida sin una llamada intermedia a una función de posicionamiento de archivos, si la operación de entrada encuentra el final del archivo.

Consulte también

Entrada y salida
Rutinas en tiempo de ejecución Universal C por categoría