Provided by: manpages-es_1.55-8_all bug

NOMBRE

       stdio - funciones de biblioteca de entrada/salida estándar.

SINOPSIS

       #include <stdio.h>

       FILE *stdin;
       FILE *stdout;
       FILE *stderr;

DESCRIPCIÓN

       La  biblioteca  de  E/S  estándar  proporciona  una  interfaz  de flujo
       (stream) utilizando un sistema de buffers (memoria intermedia) simple y
       eficiente.  La entrada y la salida se mapean en flujos lógicos de datos
       y las  caracteristicas  fisicas  de  E/S  permanecen  ocultas  para  el
       programador.  Las funciones y las macros se muestran mas adelante; para
       mas información se puede recurrir a las paginas del manual individuales
       para cada una de ellas.

       Un  flujo  se  asocia  con un archivo externo (el cual debe estar en un
       dispositivo físico) abriendo un archivo, el cual se supone que debe ser
       creado.  Crear un archivo existente hara que dicho archivo quede vacio.
       Si un archivo soporta posicionamiento (como un archivo en disco,  y  en
       contraposición  a lo que ocurre con un archivo de terminal) entonces un
       marcador de posicin asociado al flujo  se  situará  al  principio  del
       archivo (byte cero), a no ser que el archivo sea abierto en modo añadir
       (append). Si se utiliza esta última modalidad de apertura, el  marcador
       de posición será situado al final del archivo. el indicador de posicion
       se mantiene en sucesivas  lecturas,  escrituras  y  reposicionamientos.
       Todas las entradas se hacen como si los caracteres hubieran sido leidos
       mediante sucesivas llamadas a la función fgetc(3) todas las salidas  se
       producen  como  si todos los caracteres fueran leidos mediante llamadas
       sucesivas a la función fputc(3)

       Un archivo se desentiende de  un  flujo  cerrando  dicho  archivo.  Los
       flujos  de  salida  son  descargados  (toda  el contenido de la memoria
       intermedia que no fue escrita al archivo, se transmite en ese  momento)
       antes  de  que  el  flujo  se  desentienda  del fichero. El valor de un
       puntero que apunta a un objeto FILE es indeterminado tras el cierre del
       archivo.

       Un   archivo  sera  reabierto  repitidamente,  por  la  misma  u  otras
       ejecuciones de un programa, y sus contenidos seran leidos o modificados
       (si se puede reposicionar al principio). Si la función main() retorna a
       quien llamo al programa, o se utiliza  la  función  exit(3)  todos  los
       archivos  abiertos seran cerrados (consecuentemente todos los flujos de
       salida serán descargados sobre sus respectivos ficheros) antes  de  que
       se produzca el cierre efectivo del programa.Otras formas de terminar un
       programa  como  abort(3)  no  se  preocupan  de  cerrar  los   archivos
       apropiadamente.

       Cuando  el  programa  comienza,  tres  flujos  de  texto se inician por
       defecto y no necesitan ser abiertas explicitamente —  entrada  estndar
       (para  la  lectura de la entrada convencional), — salida estndar (para
       la escritura de la salida convencional)  —  salida  de  error  estndar
       (para   la   salida   de   diagnósticos).  Estos  flujos  se  abrevian,
       respectivamente, como stdin,stdout y stderr.  Una vez abierta, el flujo
       de  errores  estándar  no  utiliza  memoria  intermedia totalmente; los
       flujos estándar de entrada y salida lo harán solamente en  el  caso  de
       que dichos flujos no hagan referencia a un dispositivo interactivo.

       Los  flujos  de  salida  que  hacen  referencia  a dispositivos de tipo
       terminal, siempre utilizan memorias intermedias lineales  por  defecto;
       durante  la salida hacia cada flujo se escribe automáticamente un flujo
       de entrada que hace referencia al dispositivo terminal que lee. En  los
       casos  donde  se  requieren una enorme cantidad de calculos, despues de
       imprimir parte de una linea en un  terminal  de  salida,  es  necesario
       efectuar  una  descarga  de la memoria intermedia en el flujo de salida
       estándar mediante fflush(3) antes de dejarlo y  comenzar  los  calculos
       para que la salida aparezca.

       La  biblioteca  stdio  es  parte de la biblioteca libc y las rutinas se
       cargan automaticamente segun son necesitadas por los compiladores cc(1)
       y  pc(1).   Las secciones SINOPSIS de las siguientes paginas del manual
       indican que archivos de cabecera (include)  deben  ser  utilizados,  en
       forma  de  la  declaración  de  la  función  y  mostrando que variables
       externas resultan de interes.

       Las siguientes están definidas como macros; estos nombres no deben  ser
       reutilizados  sin  eliminar  primero sus definiciones actuales mediante
       #undef: BUFSIZ, EOF,  FILENAME_MAX,  FOPEN_MAX,  L_cuserid,  L_ctermid,
       L_tmpnam,  NULL,  SEEK_END, SEEK_SET, SEE_CUR, TMP_MAX, clearerr, feof,
       ferror, fileno, fropen, fwopen, getc, getchar, putc,  putchar,  stderr,
       stdin,  stdout.   Existén  versiones  como  función de las macros feof,
       ferror, clearerr, fileno,  getc,  getchar,  putc,  y  putchar  y  serán
       utilizadas  si  las  definiciones  de  las  macros  han sido eliminadas
       explicitamente.

LISTA DE FUNCIONES

       Función   Descripción

       clearerr  comprueba y reinicia el estado del flujo

       fclose    cierra un flujo

       fdopen    funciones de apertura de flujo

       feof      comprueba y reinicia el estado del flujo

       ferror    comprueba y reinicia el estado del flujo

       fflush    descarga la memoria intermedia del flujo sobre el fichero

       fgetc     recoge el próximo caracter de un flujo de entrada

       fgetpos   reposición en un flujo

       fgets     recoge una linea de un flujo de entrada

       fileno    comprueba y reinicia el estado del flujo

       fopen     funciones de apertura de flujo

       fprintf   conversión para salida formateada.

       fpurge    descarga el buffer de un flujo sobre el fichero

       fputc     envia un caracter o una palabra a un flujo

       fputs     envia una línea a un flujo

       fread     entrada/salida binaria

       freopen   funciones de apertura de flujo

       fropen    abre un flujo

       fscanf    conversión para entrada con formato

       fseek     reposiciona un flujo

       fsetpos   reposiciona un flujo

       ftell     reposiciona un flujo

       fwrite    entrada/salida binaria

       getc      recoge el próximo carácter o palabra de un flujo de entrada

       getchar   recoge el próximo caracter o palabra de un flujo de entrada

       gets      recoge una línea de un flujo

       getw      recoge el próximo caracter o palabra de un flujo de entrada

       mktemp    crea un nombre de archivo temporal (único)

       perror    mensajes de error del sistema

       printf    conversión para salida formateada

       putc      envia un carácter o palabra a un flujo

       putchar   envía un carácter o palabra a un flujo

       puts      envía una línea a un flujo

       putw      envía un carácter o palabra a un flujo

       remove    elimina una entrada de directorio

       rewind    reposiciona un flujo

       scanf     conversión para entrada formateada

       setbuf    operaciones de flujo con memoria intermedia

       setbuffer operaciones de flujo con memoria intermedia

       setlinebuf
                 operaciones de flujo con memoria intermedia

       setvbuf   operaciones de flujo con memoria intermedia

       sprintf   conversión para salida formateada

       sscanf    conversión para entrada formateada

       strerror  mensajes de error del sistema

       sys_errlist
                 mensajes de error del sistema

       sys_nerr  mensajes de error del sistema

       tempnam   rutinas para archivado temporal

       tmpfile   rutinas para archivado temporal

       tmpnam    rutinas para archivado temporal

       ungetc    ignora un carácter de un flujo de entrada

       vfprintf  conversión para salida formateada

       vfscanf   conversión para entrada formateada

       vprintf   conversión para salida formateada

       vscanf    conversión para entrada formateada

       vsprintf  conversión para salida formateada

       vsscanf   conversión para entrada formateada

CONFORME A

       La biblioteca stdio es conforme con ANSI X3.159-1989 (‘‘ANSI C’’).

VÉASE TAMBIÉN

       open(2), close(2), read(2), write(2), stdout(3)

                               26 diciembre 2001                      STDIO(3)