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

NOMBRE

       stdio - funciones de biblioteca de entrada/salida estandar.

SINOPSIS

       #include <stdio.h>

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

DESCRIPCI'ON

       La  biblioteca  de  E/S  estandar  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 logicos 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 informacion 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 fisico) 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
       contraposicion  a lo que ocurre con un archivo de terminal) entonces un
       marcador de posici'on asociado al flujo  se  situara  al  principio  del
       archivo (byte cero), a no ser que el archivo sea abierto en modo anadir
       (append). Si se utiliza esta ultima modalidad de apertura, el  marcador
       de posicion sera 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 funcion fgetc(3) todas las salidas  se
       producen  como  si todos los caracteres fueran leidos mediante llamadas
       sucesivas a la funcion 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 funcion main() retorna a
       quien llamo al programa, o se utiliza  la  funcion  exit(3)  todos  los
       archivos  abiertos seran cerrados (consecuentemente todos los flujos de
       salida seran 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  est'andar
       (para  la lectura de la entrada convencional), -- salida est'andar (para
       la escritura de la salida convencional) --  salida  de  error  est'andar
       (para   la   salida   de   diagnosticos).  Estos  flujos  se  abrevian,
       respectivamente, como stdin,stdout y stderr.  Una vez abierta, el flujo
       de  errores  estandar  no  utiliza  memoria  intermedia totalmente; los
       flujos estandar de entrada y salida lo haran 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 automaticamente 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
       estandar 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  declaracion  de  la  funcion  y  mostrando que variables
       externas resultan de interes.

       Las siguientes estan 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.   Existen  versiones  como  funcion de las macros feof,
       ferror, clearerr, fileno,  getc,  getchar,  putc,  y  putchar  y  seran
       utilizadas  si  las  definiciones  de  las  macros  han sido eliminadas
       explicitamente.

LISTA DE FUNCIONES

       Funci'on   Descripci'on

       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 proximo caracter de un flujo de entrada

       fgetpos   reposicion 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   conversion 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 linea a un flujo

       fread     entrada/salida binaria

       freopen   funciones de apertura de flujo

       fropen    abre un flujo

       fscanf    conversion para entrada con formato

       fseek     reposiciona un flujo

       fsetpos   reposiciona un flujo

       ftell     reposiciona un flujo

       fwrite    entrada/salida binaria

       getc      recoge el proximo caracter o palabra de un flujo de entrada

       getchar   recoge el proximo caracter o palabra de un flujo de entrada

       gets      recoge una linea de un flujo

       getw      recoge el proximo caracter o palabra de un flujo de entrada

       mktemp    crea un nombre de archivo temporal (unico)

       perror    mensajes de error del sistema

       printf    conversion para salida formateada

       putc      envia un caracter o palabra a un flujo

       putchar   envia un caracter o palabra a un flujo

       puts      envia una linea a un flujo

       putw      envia un caracter o palabra a un flujo

       remove    elimina una entrada de directorio

       rewind    reposiciona un flujo

       scanf     conversion 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   conversion para salida formateada

       sscanf    conversion 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 caracter de un flujo de entrada

       vfprintf  conversion para salida formateada

       vfscanf   conversion para entrada formateada

       vprintf   conversion para salida formateada

       vscanf    conversion para entrada formateada

       vsprintf  conversion para salida formateada

       vsscanf   conversion para entrada formateada

CONFORME A

       La biblioteca stdio es conforme con ANSI X3.159-1989 (``ANSI C'').

V'EASE TAMBI'EN

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

                               26 diciembre 2001                      STDIO(3)