- Stdio.h
-
stdio.h
stdio.h, que significa "standard input-output header" (cabecera estandar E/S), es la biblioteca estándar del lenguaje de programación C, el archivo de cabecera que contiene las definiciones de macros, las constantes, las declaraciones de funciones y la definición de tipos usados por varias operaciones estándar de entrada y salida. Por motivos de compatibilidad, el lenguaje de programación C++ (derivado de C) también tiene su propia implementación de estas funciones, que son declaradas con el archivo de cabecera cstdio.
Las funciones declaradas en
stdio.h
son sumamente populares.Contenido
Ejemplo de uso
En C y sus derivados, todas las funciones son declaradas en archivos de cabecera. Así, los programadores tienen que incluir el archivo de cabecera stdio.h dentro del código fuente para poder utilizar las funciones que están declaradas. nota: el compilador diferencia las mayusculas entre las minusculas.
#include <stdio.h> int main(void) { int ch; while ((ch = getchar()) != EOF) putchar(ch); putchar('\n'); return 0; }
El programa lee todas las entradas desde la entrada estándar y las muestra en la salida estándar, línea a línea.
Funciones miembro
Las funciones declaradas en
stdio.h
pueden clasificarse en dos categorías: funciones de manipulación de ficheros y funciones de manipulación de entradas y salidas.Nombre Descripción Funciones de manipulación de ficheros fclose
cierra un fichero a través de su puntero fopen, freopen, fdopen
abre un fichero para lectura, para escritura/reescritura o para adición remove
elimina un fichero rename
cambia al fichero de nombre rewind
La función rewind coloca el indicador de posición de fichero para el stream apuntado por stream al comienzo del fichero. tmpfile
crea y abre un fichero temporal que es borrado cuando cerramos con la función fclose() Funciones de manipulación de entradas y salidas clearerr
Despeja los indicadores de final de fichero y de posición de fichero para el stream apuntado por stream al comienzo del fichero. feof
comprueba el indicador de final de fichero ferror
comprueba el indicador de errores fflush
Si stream apunta a un stream de salida o de actualización cuya operación más reciente no era de entrada, la función fflush envía cualquier dato aún sin escribir al entorno local o a ser escrito en el fichero; si no, entonces el comportamiento no está definido. Si stream es un puntero nulo, la función fflush realiza el despeje para todos los streams cuyo comportamiento está descrito anteriormente. fgetpos
devuelve la posición actual del fichero fgetc
devuelve un carácter de un fichero fgets
consigue una cadena de caracteres de un fichero fputc
escribe un carácter en un fichero fputs
escribe una cadena de caracteres en un fichero ftell
devuelve la posición actual del fichero como número de bytes fseek
sitúa el puntero de un fichero en una posición aleatoria fsetpos
cambia la posición actual de un fichero fread
lee diferentes tamaños de datos de un fichero fwrite
envía, desde el array apuntado por puntero, hasta nmemb de elementos cuyo tamaño es especificado por tamanyo.El indicador de posición de ficheros es avanzado por el número de caracteres escritos correctamente. Si existe un error, el valor resultante del indicador de posición de ficheros es indeterminado. getc
devuelve un carácter desde un fichero getchar
igual que getc gets
lee caracteres de entrada hasta que encuentra un salto de línea, y los almacena en un único argumento. printf, fprintf, sprintf
snprintfusados para imprimir salidas de datos vprintf
también utilizado para imprimir salidas perror
escribe un mensaje de error a stderr putc
devuelve un carácter de un fichero putchar, fputchar
igual que putc(stdout) scanf, fscanf, sscanf
utilizado para introducir entradas. vfscanf, vscanf, vsscanf
también utilizado para introducir entradas. setbuf
Esta función es equivalente a la función setvbuf pasando los valores _IOFBF para modo y BUFSIZ para tamaño, o (si acumulador es un puntero nulo), con el valor _IONBF para modo. setvbuf
sólo puede ser usada después de que el stream apuntado por stream ha sido asociado con un fichero abierto y antes de otra operación cualquiera es llevada acabo al stream. El argumento modo determina cómo stream será almacenado según lo siguiente: _IOFBF ocasiona la entrada/salida a ser completamente almacenado; _IOLBF ocasiona la entrada/salida a almacenar por líneas; _IONBF ocasiona la entrada/salida a no ser almacenado. Si acumulador no es un puntero nulo, el array al que es apuntado puede ser usado en vez de la acumulación adjudicada por la función setvbuf. El argumento tamanyo especifica el tamaño del array. tmpnam
Genera una cadena de caracteres que es un nombre válido para ficheros y que no es igual al nombre de un fichero existente. La función tmpnam genera una cadena diferente cada vez que es llamada, hasta un máximo de TMP_MAX veces. Si la función es llamada más veces que TMP_MAX, entonces el comportamiento de la función está definido según la implementación del compilador. ungetc
puts
imprime una de cadena de caracteres Constantes miembro
Las constantes definidas en el fichero cabecera
stdio.h
son:Nombre Descripción EOF
entero negativo ( int
) usado para indicar "fin de fichero"BUFSIZ
entero que indica el tamaño del buffer utilizado por la función setbuf()
FILENAME_MAX
tamaño máximo de la cadena de caracteres que contienen el nombre de un fichero para ser abierto FOPEN_MAX
Número máximo de ficheros que pueden estar abiertos simultáneamente _IOFBF
abreviatura de input/output fully buffered (buffer entrada/salida totalmente lleno); es un entero que se puede pasar como parámetro de la función setvbuf()
para requerir bloqueo del buffer en la entrada y salida del stream abierto_IOLBF
abreviatura de input/output line buffered (...??); es un entero que se puede pasar como parametro a la función setvbuf()
para requerir line buffered (??) en la entrada y salida del stream abierto_IONBF
abreviatura de "input/output not buffered" (entrada/salida sin buffer); es un entero que se puede pasar como parametro a la función setvbuf()
para requerir que la entrada salida del stream abierto funcione sin bufferL_tmpnam
tamaño de la cadena de caractres con la longitud suficiente para almacenar un nombre de fichero temporal generado por la función tmpnam()
NULL
macro que representa la constante puntero nulo; representa un valor de puntero que no apunta a ninguna dirección válida de objeto alguno en memoria SEEK_CUR
entero que se puede pasar como parámetro a la función fseek()
para indicar posicionamiento relativo a la posición actual del ficheroSEEK_END
entero que se puede pasar como parámetro a la función fseek()
para indicar posicionamiento relativo al final del ficheroSEEK_SET
entero que se puede pasar como parámetro a la función fseek()
para indicar posicionamiento relativo al inicio del ficheroTMP_MAX
el número máximo de nombres de ficheros únicos generables por la función tmpnam()
Variables miembro
El fichero de cabecera
stdio.h
define las siguientes variables:Nombre Descripción stdin
puntero a FILE
que referencia la entrada estándar, normalmente el tecladostdout
puntero a FILE
que referencia la salida estándar, normalmente el monitorstderr
puntero a FILE
que referencia la salida de error estándar, normalmente el monitorTipos miembro
Los tipos de datos definidos en el fichero de cabecera
stdio.h
son:FILE
- estructura que contiene información sobre el fichero o stream (flujo) de texto necesario para realizar las operaciones de entrada/salida sobre él. incluye:- posición actual de stream
- indicador de fin de fichero (EOF)
- indicador de error
- puntero al buffer del stream
fpos_t
- tipo no-array capaz de identificar unívocamente la posición de cada byte en un archivosize_t
- tipo entero sin signo (positivo); es el tipo devuelto por el operadorsizeof
Véase también
- Lenguaje de programación C
- Código stdlih.h
Categorías: Biblioteca estándar de C | Cabeceras de C
Wikimedia foundation. 2010.