CKTIS / C
sscanf — lire des données formatées depuis une chaîne
sscanf, déclaré dans <stdio.h>, lit des données selon un format à partir d’une chaîne terminée par un caractère nul. Il stocke les résultats via des pointeurs et renvoie le nombre d’affectations réussies (hors `%n`), pas le nombre de caractères lus.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdio.h>
int sscanf(const char * restrict s, const char * restrict format, ...);sscanf fonctionne comme fscanf, mais lit une chaîne plutôt qu’un flux. Le format décrit les conversions et les caractères littéraux requis. %d nécessite un int * ; utilisez &age. Pour le tableau name, passez name lui-même.
Vérifiez la valeur de retour avant d’utiliser les données : elle compte les affectations réussies et peut être inférieure au nombre attendu ou égale à 0. La directive %n enregistre le nombre de caractères lus jusque-là, mais n’incrémente pas la valeur de retour. EOF indique une erreur d’entrée avant la fin de la première conversion. Des affectations réussies ne garantissent pas que toute la chaîne a été consommée.
%s ignore les espaces blancs initiaux, lit un mot et ajoute un caractère nul. %7s nécessite au moins 8 éléments char. La plupart des conversions ignorent les espaces blancs initiaux ; %c, %[ et %n ne le font pas.
Un type de pointeur incompatible, un résultat numérique qui n’est pas représentable dans l’objet de destination ou une copie entre des objets qui se chevauchent entraîne un comportement indéfini. La largeur de champ ne vérifie pas l’étendue numérique. Dans l’exemple, les deux résultats ne sont utilisés qu’après vérification de count == 2.
Exemples
#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;
}Résultat
Ada: 42
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.