Función de la biblioteca C -fscanf()
Biblioteca estándar de C - <stdio.h>
Descripción
Función de la biblioteca Cint fscanf(FILE *stream, const char *format, ...)Lee la entrada formateada desde el flujo (stream).
Declaración
A continuación se muestra la declaración de la función fscanf().
int fscanf(FILE *stream, const char *format, ...)
Parámetros
- stream-- Este es un puntero a un objeto FILE, que identifica el flujo.
- format-- Es una cadena de C que contiene uno o más de los siguientes elementos:caracteres de espacio, caracteres que no son de espacioyespecificadores de formato。
El especificador de formato tiene la forma[=%[*][width][modifiers]type=]que se detalla a continuación:
| Parámetros | Descripción |
|---|---|
| * | Este es un asterisco opcional que indica que los datos se leen desde el flujo (stream), pero pueden ignorarse, es decir, no se almacenan en el parámetro correspondiente. |
| width | Esto especifica el número máximo de caracteres a leer en la operación de lectura actual. |
| modifiers | Especifica un tamaño para los datos a los que apunta el parámetro adicional correspondiente, que es diferente de entero (para d, i y n), entero sin signo (para o, u y x) o punto flotante (para e, f y g): h : entero corto (para d, i y n), o entero corto sin signo (para o, u y x) l : entero largo (para d, i y n), o entero largo sin signo (para o, u y x), o doble precisión (para e, f y g) L : long double (para e, f y g) |
| type | Un carácter que especifica el tipo de datos a leer y la forma de leerlos. Consulte la siguiente tabla para más detalles. |
Especificadores de tipo de fscanf:
| Tipo | Entrada válida | Tipo del parámetro |
|---|---|---|
| c | Carácter individual: lee el siguiente carácter. Si se especifica un ancho width distinto de 1, la función lee width caracteres y, a través del parámetro, los almacena en posiciones consecutivas de un arreglo. Al final no se añade un carácter nulo. | char * |
| d | Entero decimal: el signo + o - delante del número es opcional. | int * |
| e,E,f,g,G | Número de punto flotante: incluye un punto decimal, un signo inicial opcional + o -, un carácter final opcional e o E, y un número decimal. Dos ejemplos válidos son -732.103 y 7.12e4. | float * |
| o | Entero octal. | int * |
| s | Cadena. Esto lee caracteres consecutivos hasta encontrar un carácter de espacio en blanco (el carácter de espacio en blanco puede ser un espacio, un salto de línea o una tabulación). | char * |
| u | Entero decimal sin signo. | unsigned int * |
| x,X | Entero hexadecimal. | int * |
- Parámetros adicionales-- Dependiendo de la cadena de formato, la función puede requerir una serie de parámetros adicionales, cada uno de los cuales contiene un valor que se insertará, reemplazando cada etiqueta % especificada en el parámetro format. El número de parámetros debe ser el mismo que el número de etiquetas %.
Valor de retorno
Si tiene éxito, la función devuelve el número de coincidencias y asignaciones exitosas. Si se llega al final del archivo o se produce un error de lectura, devuelve EOF.
Ejemplo
El siguiente ejemplo demuestra el uso de la función fscanf().
#include <stdio.h>
#include <stdlib.h>
int main()
{
char str1[10], str2[10], str3[10];
int year;
FILE * fp;
fp = fopen ("file.txt", "w+");
fputs("We are in 2014", fp);
rewind(fp);
fscanf(fp, "%s %s %s %d", str1, str2, str3, &year);
printf("Read String1 |%s|\n", str1 );
printf("Read String2 |%s|\n", str2 );
printf("Read String3 |%s|\n", str3 );
printf("Read Integer |%d|\n", year );
fclose(fp);
return(0);
}
Compilemos y ejecutemos el programa anterior, lo que producirá el siguiente resultado:
Read String1 |We| Read String2 |are| Read String3 |in| Read Integer |2014|Otras extensiones