CKTIS / C
fscanf — función de flujo de C23
`fscanf(stream, format, ...)` de `<stdio.h>` lee caracteres de un flujo según directivas de formato y guarda las conversiones mediante argumentos puntero sucesivos. Devuelve el número de asignaciones realizadas, o `EOF` si ocurre un fallo de entrada antes de la primera conversión.
Versión: C23
Sintaxis
int fscanf(FILE * restrict stream, const char * restrict format, ...);fscanf(stream, format, ...) de <stdio.h> lee caracteres de un flujo según directivas de formato y guarda las conversiones mediante argumentos puntero sucesivos. Devuelve el número de asignaciones realizadas, o EOF si ocurre un fallo de entrada antes de la primera conversión.
El ejemplo escribe 7 2.50 blue en un archivo temporal y lo analiza con "%d %lf %4s" en un int, un double y un array de cinco char. 3 7 2.50 blue confirma tres asignaciones y la conversión de cadena acotada.
Un fallo de coincidencia antes de asignar devuelve 0; fin de archivo o error de lectura antes de convertir devuelve EOF; %n no aumenta el recuento. Cada tipo de puntero debe corresponder exactamente a la conversión. Para %s y %[ usa una anchura como máximo capacidad menos uno, o puede haber desbordamiento y comportamiento indefinido.
Ejemplos
#include <stdio.h>
int main(void){FILE *stream=tmpfile();if(!stream)return 1;if(fputs("7 2.50 blue",stream)==EOF){fclose(stream);return 1;}rewind(stream);int count=0,number=0;double price=0.0;char color[5]={0};count=fscanf(stream,"%d %lf %4s",&number,&price,color);printf("%d %d %.2f %s\n",count,number,price,color);return fclose(stream)==0?0:1;}
Resultado
3 7 2.50 blue
El ejemplo escribe `7 2.50 blue` en un archivo temporal y lo analiza con `"%d %lf %4s"` en un `int`, un `double` y un array de cinco `char`. `3 7 2.50 blue` confirma tres asignaciones y la conversión de cadena acotada.