Funciones C (gnu/linux)

11,558 views

Published on

Published in: Technology
0 Comments
2 Likes
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total views
11,558
On SlideShare
0
From Embeds
0
Number of Embeds
103
Actions
Shares
0
Downloads
108
Comments
0
Likes
2
Embeds 0
No embeds

No notes for slide

Funciones C (gnu/linux)

  1. 1. Funciones de librerías C GNU/Linux Copyright (c) 2006, Jose Daniel Gutiérrez Porset josedaniel.gutierrez@ehu.es
  2. 2. Licencia de Uso Acerca de este documento Copyright (c) 2006, Jose Daniel Gutiérrez Porset josedaniel.gutierrez@ehu.es Se otorga permiso para copiar, distribuir y/o modificar este documento bajo los términos de la Licencia de Documentación Libre de GNU en su versión 1.2 o cualquier otra versión posterior publicada por la Free Software Foundation, siendo todo él invariante. Una copia de la licencia está disponible en la web de la Free Software Foundation, dentro de la sección titulada GNU Free Documentation License. Este documento ha sido realizado íntegramente con software libre. 2
  3. 3. Índice Licencia de uso de este documento ● Ayuda de funciones ● Cuadros sinópticos ● Funciones ● 3
  4. 4. Ayuda de funciones Paquete debian/ubuntu/...: manpages-dev ● Comandos desde la shell: ● apropos <todo_o_parte_de_nombre_funcion> – man nombre_funcion – man 2 nombre_funcion – man 3 nombre_funcion – 4
  5. 5. Cuadros sinópticos Funciones de E/S mediante streams Tabla de funciones de gestión de streams en stdio.h ● Función E/S stream Contenido Destino Origen Comentarios printf S stdout texto Argumentos según formato putchar S stdout texto Carácter puts S stdout texto Cadena Añade salto de línea scanf E stdin texto Argumentos según formato getchar E stdin texto Carácter gets E stdin texto Cadena A diferencia de fgets no establece tamaño máx. fprintf S FILE * texto Argumentos según formato fputc S FILE * texto Carácter Hay una macro estándar equivalente: putc fputs S FILE * texto Cadena No añade salto de línea fscanf E FILE * texto Argumentos según formato fgetc E FILE * texto Carácter Hay una macro estándar equivalente: getc fgets E FILE * texto Cadena fwrite S FILE * binario Zona de memoria fread E FILE * binario Zona de memoria 5
  6. 6. Cuadros sinópticos Funciones de streams Características comúnes a las funciones indicadas: ● Funcionan con buffers de entrada y salida, y no los limpian previamente. Tiene que ver con  – la espera a que esté el buffer lleno (en salida se mejora el rendimiento; en el caso de un  buffer de entrada, se puede editar). Los buffers pueden ser de tres tipos: completo, de línea  (ej. las de stdin) o nulo. En el caso de las funciones que leen de la entrada estándar, se hace eco a la pantalla si no  – hay redirección a fichero. Todas las indicadas son estándar, y existen tanto en GNU/Linux como en Ms DOS/Windows. – Hay otras funciones no estándares, dependientes de S.O. y que operan sobre la terminal (no  – sobre streams de E/S). Ej. en el caso de Ms, se definen en conio.h las siguientes: getche,  getch, putch. Su comportamiento difiere según hagan o no eco, etc. Regla nemotécnica para ubicación de parámetro FILE * en las declaraciones: siempre es el último  ● parámetro excepto en fprintf y fscanf donde es el primero 6
  7. 7. Funciones void *calloc (size_t num_elem, size_t tam_bytes); ● malloc.h, stdlib.h – Reserva dinámica de memoria de num_elem x tam_bytes – Valor devuelto: puntero a la memoria asignada, o NULL si la  – petición falla void clearerr( FILE *stream); ● stdio.h – Limpia los indicadores de fin de fichero y error para un stream  – concreto 7
  8. 8. Funciones int fclose (FILE *stream); ● stdio.h – Cerrar stream – Valor de retorno: en caso de éxito 0, y si error ­1 – int feof (FILE *stream); ● stdio.h – Indicador de fin de fichero – Valor de retorno: en caso de no haberse intentado leer o escribir al  – final del fichero devuelve 0 8
  9. 9. Funciones int ferror (FILE *stream); ● stdio.h – Indicador de error – Valor de retorno: devuelve el último código de error  – correspondiente a una operación de streams sobre un stream  concreto, o 0 si no lo ha habido. int fflush (FILE *stream); ● stdio.h – Volcado de buffers de salida – 9
  10. 10. Funciones int fgetc(FILE *stream); ● stdio.h – Idem que getchar sobre un stream – char *fgets(char *destino, int n, FILE *stream); ● stdio.h – Lee desde un stream como mucho n­1 caracteres, o hasta encontrar  – un salto de línea (que lo mantiene) o fin de fichero Añade un '0' al final – Valor de retorno: s en caso de éxito, y NULL en caso de error o si  – se llega al final del stream 10
  11. 11. Funciones FILE *fopen (char *nomfich, char *modo); ● stdio.h – Abrir stream. Parámetro modo: – Modo ¿Puede ¿Puede Posición Si existe Si no existe el leer? escribir? en fichero el fichero fichero “r” Sí No Principio No lo borra Da error “r+” Sí Sí Principio No lo borra Da error “w” No Sí Principio Lo borra Lo crea “w+” Sí Sí Principio Lo borra Lo crea “a” No Sí Final No lo borra Lo crea “a+” Sí Sí Final No lo borra Lo crea ­    modo puede incluir la letra 'b' como carácter final o entre dos cualesquiera por   compatibilidad con ANSI C, pero en los sistemas POSIX (GNU/Linux,...) no tiene efecto ­    Si se abre con +, hay que sincronizar buffers entre operaciones: para leer después de  escribir, llamar antes a fflush o a una función de posicionamiento (fseek,fsetpos,rewind).  Para escribir tras leer, hacer un reposicionamiento, a no ser que sea al final del fichero Valor de retorno: en caso de error, devuelve NULL – 11
  12. 12. Funciones int fprintf(FILE *stream, const char ● *formato, ...); stdio.h – Idem que printf sobre un stream – void __fpurge(FILE *stream); ● stdio_ext.h – Volcado de buffers de entrada – No es estándar: Sólo en GNU/Linux – 12
  13. 13. Funciones int fputc(int caracter, FILE *stream); ● stdio.h – Idem que putchar sobre un stream – int fputs(const char *origen, FILE *stream); ● stdio.h – Idem que puts sobre un stream – No añade 'n' – 13
  14. 14. Funciones size_t fread( void *ptr, size_t tam_bytes, size_t ● num_elem, FILE *stream); stdio.h – Lectura de elementos de memoria – Valor de retorno: nº de elementos (no de caracteres) leídos  – correctamente. Si ocurre un error o se llega al fin­de­fichero, el  valor devuelto es un nº menor del esperado (o cero). fread no distingue entre fin­de­fichero y error, así que quien llame  a esta función debe emplear feof y ferror para determinar qué ha  ocurrido. void free (void * ptr); ● malloc.h, stdlib.h – Liberación de memoria reservada dinámicamente – 14
  15. 15. Funciones FILE *freopen(char *nomfich, char *modo, ● FILE *stream); stdio.h – Redireccionar un stream: se abre el fichero nomfich y le asocia el   – stream __stream. Éste se cierra si existe. El argumento modo se emplea igual que en la función fopen. – Un uso típico es cambiar el fichero asociado con un stream  – estándar (stderr, stdin, o stdout). Valor de retorno: en caso de error, devuelve NULL – 15
  16. 16. Funciones int fscanf(FILE *stream, const char *formato, ...); ● stdio.h – Idem que scanf aplicado sobre un stream – int fseek (FILE *stream, long int offset, int ● origen); stdio.h – Desplazar indicador de posición un offset según origen: – SEEK_SET: relativo al comienzo del fichero (offset>0) ● SEEK_CUR: relativo a la posición actual (offset positivo o negativo) ● SEEK_END: relativo al final del fichero (offset<0) ● Valor de retorno: en caso de éxito 0, y si error ­1 – 16
  17. 17. Funciones long int ftell (FILE *stream); ● stdio.h – Obtener el valor actual del indicador de posición de un stream – Valor de retorno: en caso de error ­1 – 17
  18. 18. Funciones size_t fwrite (const void *ptr, size_t tam_bytes, ● size_t num_elem, FILE *stream); stdio.h – Escritura de elementos de memoria – Valor de retorno: nº de elementos (no de caracteres) escritos  – correctamente. Si ocurre un error o se llega al fin­de­fichero, el  valor devuelto es un nº menor del esperado (o cero). 18
  19. 19. Funciones int getchar(void); ● stdio.h – Lee de stdin un carácter – Valor de retorno: carácter leído como un unsigned char modelado  – a un int o EOF al llegar al final de la entrada o en caso de error. char *gets (char *destino); ● stdio.h – Lee de stdin hasta encontrar un salto de línea (que sustituye por  – '0') o EOF No controla desbordamiento de buffer – Valor de retorno: s en caso de éxito, y NULL en caso de error o si  – se llega al final del stream 19
  20. 20. Funciones void *malloc (size_t tam_bytes); ● malloc.h, stdlib.h – Reserva dinámica de memoria de tam_bytes – Valor de retorno: puntero a la memoria asignada, o NULL si la  – petición falla 20
  21. 21. Funciones int printf (const char *formato, ...); ● stdio.h – Saca por stdout los argumentos formateándolos según una cadena  – de control (ver cuadro) Muy importante: ha de haber correspondencia entre: – El nº de parámetros y el nº de % ● Los tipos de los argumentos y los tipos  indicados con % ● Valor de retorno: nº de caracteres impresos. Si se encuentra un  – error de salida, se devuelve un valor negativo. 21
  22. 22. Funciones Cadena de control: “%­+ 0w.pmc” (obligatorio: c) – - justif. izda. + sacar signo espacio espacio si no hay signo 0 rellenar con ceros (si no está justif. a izda.) w mínima anchura de campo p precisión m carácter de conversión: ● h: short int ● l: long int ● L: long double c carácter de conversión: ● d,i: int ● o: octal ● u: unsigned ● x,X: hexadecimal ● f: float y double ● e,E: exponencial ● g,G: idem que f, e, E según el exponente ● c: char ● s: cadena ● p: puntero 22
  23. 23. Funciones int putchar(int caracter); ● stdio.h – Saca por stdout un carácter – Valor de retorno: el carácter escrito como un unsigned char  – modelado a un int o EOF en caso de error int puts (char *cadena); ● stdio.h – Saca por stdout una cadena – Añade 'n' – Valor de retorno: número no negativo si acaban bien, o EOF en  – caso de error 23
  24. 24. Funciones void *realloc (void *ptr, size_t tam_bytes); ● malloc.h, stdlib.h – Reserva dinámica de memoria de tam_bytes a partir de una zona  – ya reservada Valor de retorno: puntero a la memoria asignada, o NULL si la  – petición falla 24
  25. 25. Funciones int remove(const char *pathname); ● stdio.h – Borrado de fichero – Valor de retorno: en caso de éxito 0, y si error ­1 – int rename(const char *oldpath, const char ● *newpath); stdio.h – Renombrar fichero – Valor de retorno: en caso de éxito 0, y si error ­1 – 25
  26. 26. Funciones void rewind (FILE *stream); ● stdio.h – Desplazar el cursor del fichero al inicio. – Es equivalente a fseek(stream, 0L, SEEK_SET). – 26
  27. 27. Funciones int scanf (const char *formato, ...); ● stdio.h – Lee de stdin e intenta convertir a tipos según según el formato indicado  – por una cadena de control. El  análisis acaba cuando  un  carácter de  la  entrada no concuerda con un carácter del formato, o bien cuando una  conversión no puede realizarse. En este caso el resto de caracteres queda  en el buffer de entrada. Separador de argumentos en la cadena de control: – En la cadena de control se interpretan igual el espacio en blanco, el  ● tabulador y el salto de línea.  Uno de éstos concuerda con cualquier  cantidad de espacio en blanco, incluyendo ninguna, en la entrada. Se puede emplear otro carácter. ● No coge el carácter de fin de línea sino que éste se elimina – No controla desbordamiento de buffer para el caso de %s – 27
  28. 28. Funciones Cadena de control: “wmc” (obligatorio: c) – w mínima anchura de campo m carácter de conversión opcional: ● h: shortint ● l: long int o long double ● L: long double c carácter de conversión: ● d,i: int ● o: octal ● u: unsigned ● x,X: hexadecimal ● f,e,g,E: float ● lf: double ● e, E: exponencial ● c: char ● s: cadena ● p: puntero En el caso de introducir números seguidos, puede inducir a confusión.  – Ej.”%d%f” si se mete 234.567 hay varias posibilidades Valor de retorno: nº de conversiones exitosas o el valor EOF si ha habido  – 28 un fallo de entrada antes de ninguna conversión
  29. 29. Funciones int sprintf (char *destino, const char ● *formato, ...); stdio.h – Idem que printf sobre una cadena – Añade '0' al final – int sscanf (char *destino, const char ● *formato, ...); stdio.h – Idem que scanf sobre una cadena – 29
  30. 30. Funciones char *strcat (char *destino, char *cadena); ● string.h – Concatenación de una cadena detrás de otra – No controla desbordamiento de buffer – Valor de retorno: puntero a la cadena destino – char *strchr (char *cadena, int caracter); ● string.h – Búsqueda de un carácter en una cadena, de izda. a dcha. – Valor de retorno: puntero al elemento de la cadena con el carácter  – coincidente, o NULL si el carácter no se ha encontrado 30
  31. 31. Funciones int strcmp (char *cadena1, char *cadena2); ● string.h – Comparación de dos cadenas – Valor de retorno: entero menor que, igual a, o mayor que cero si s1  – se encuentra que es, respectivamente, menor que, igual a, o mayor  que s2 char *strcpy (char *destino, char *origen); ● string.h – Copia de una cadena a otra – No controla desbordamiento de buffer – Valor de retorno: puntero a la cadena destino – 31
  32. 32. Funciones size_t strlen (char *cadena); ● string.h – Longitud de una cadena (nº de caracteres) – Valor de retorno: nº caracteres – char *strrchr (char *cadena, int caracter); ● string.h – Búsqueda de un carácter en una cadena, de dcha. a izda.  – char *strstr (char *cadena1, char *cadena2); ● string.h – Búsqueda de cadena cadena2 en cadena1, de izda a dcha – Valor de retorno: puntero a la aparición, o NULL si no se encuentra – 32

×