CKTIS / C
sscanf — leer datos con formato desde una cadena
sscanf, de <stdio.h>, lee datos de una cadena terminada en nulo según un formato. Guarda los resultados mediante punteros y devuelve el número de asignaciones correctas (sin contar `%n`), no el número de caracteres leídos.
Versión: C23; repository compiler flag, production runtime not attested
Sintaxis
#include <stdio.h>
int sscanf(const char * restrict s, const char * restrict format, ...);sscanf funciona como fscanf, pero lee una cadena en lugar de un flujo. El formato describe las conversiones y los caracteres literales requeridos. %d requiere un int *; usa &age. Para el array name, pasa name directamente.
Comprueba el valor devuelto antes de usar los datos: cuenta las asignaciones correctas y puede ser menor de lo esperado o igual a 0. La directiva %n guarda el número de caracteres leídos hasta ese momento, pero no incrementa el valor devuelto. EOF indica un error de entrada antes de que termine la primera conversión. Las asignaciones correctas no garantizan que se haya consumido toda la cadena.
%s omite los espacios en blanco iniciales, lee una palabra y añade un carácter nulo. %7s necesita al menos 8 elementos char. La mayoría de las conversiones omiten los espacios en blanco iniciales; %c, %[ y %n no lo hacen.
Un tipo de puntero incompatible, un resultado numérico que no se pueda representar en el objeto de destino o copiar entre objetos que se solapan provoca un comportamiento indefinido. La anchura de campo no comprueba el rango numérico. En el ejemplo, ambos resultados solo se usan después de comprobar count == 2.
Ejemplos
#include <stdio.h>
int main(void)
{
const char input[] = "Ada 42";
char name[8];
int age;
int count = sscanf(input, "%7s %d", name, &age);
if (count != 2) {
puts("Parse failed");
return 1;
}
printf("%s: %d\n", name, age);
return 0;
}Resultado
Ada: 42
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.