SSCANF

Syntaxe

Paramètres

Description

Cette fonction permet la lecture de texte suivant un certain format à partir d'un tampon.

Remarques

• La fonction sscanf() est identique à scanf() sauf que les données sont lues à partir du tableau pointé par tampon plutôt que stdin (entrée standard).
• La valeur de retour est égale au nombre de variables auxquelles des valeurs ont été réellement affectées. Ce nombre ne comprend pas les champs ayant été ignorés lors de l'utilisation du modificateur de commande de format *. Une valeur de zéro signifie qu'aucun champ n'a été attribué et un EOF indique qu'une erreur s'est produite avant la première affectation.
• Utilisation pour extraire des données d'une chaîne : sscanf est utilisée pour analyser des chaînes contenant plusieurs données formatées. Exemple :
1. char data[] = "42 3.14 hello";
2. int i;
3. float f;
4. char str[10];
5. sscanf(data, "%d %f %s", &i, &f, str);

Ici, sscanf extrait 42 en int, 3.14 en float, et "hello" en char[].

• Retourne le nombre de conversions réussies : sscanf retourne le nombre de champs correctement extraits, ce qui permet de vérifier si l'opération a réussi. Exemple :
1. int a, b;
2. int res = sscanf("100 abc", "%d %d", &a, &b); 

Ici, res vaudra 1 car seul 100 peut être converti en int, tandis que "abc" échoue.

• Gestion des espaces et des séparateurs : Par défaut, sscanf ignore les espaces, tabulations et nouvelles lignes entre les valeurs. Exemple :
1. char str[] = "123 456\t789\n";
2. int a, b, c;
3. sscanf(str, "%d %d %d", &a, &b, &c);

Il extraira 123, 456 et 789 même si les séparateurs sont variés.

• Vérification des erreurs et sécurité : sscanf ne signale pas directement les erreurs, il faut vérifier le retour pour éviter des comportements indéfinis. Mauvais exemple :
1. int value;
2. sscanf("abc", "%d", &value); // Échec de conversion, `value` reste indéfini

Il est recommandé d'initialiser les variables avant l'appel.

• Limitations de sécurité et alternatives : sscanf ne vérifie pas les dépassements de mémoire lors de la lecture des chaînes (%s). Solution : Limiter la taille des entrées :
1. char str[14];
2. sscanf("BonjourLeMonde!", "%9s", str); // Évite un dépassement

Une alternative plus sécurisée en C++ est std::istringstream de <sstream>.

• Lecture de formats spécifiques : sscanf peut traiter différents types de données et même des formats complexes. Exemple pour lire une date :
1. char date[] = "2024-02-06";
2. int year, month, day;
3. sscanf(date, "%d-%d-%d", &year, &month, &day);

Cela permet d'extraire 2024, 2 et 6 séparément.

• Utilisation avec des expressions régulières et alternatives modernes : sscanf n'a pas de support natif pour les expressions régulières, ce qui peut limiter son usage pour des formats complexes. Pour des analyses avancées, utiliser :
• std::regex (C++11) pour les correspondances avancées.
• std::istringstream pour de l'analyse plus contrôlé.

Exemple avec std::regex :

1. std::regex pattern(R"((\d+)-(\d+)-(\d+))");
2. std::smatch matches;
3. std::string date = "2024-02-06";
4. if (std::regex_search(date, matches, pattern)) {
5.     int year = std::stoi(matches[1]);
6.     int month = std::stoi(matches[2]);
7.     int day = std::stoi(matches[3]);
8. }

Exemple

Voici un exemple permettant d'extraire trois valeurs d'une chaîne de caractères :

Essayer maintenant !

on obtiendra le résultat suivant :

Voir également

Langage de programmation - C++ - Référence de procédures et fonctions - fscanf
Langage de programmation - C++ - Référence de procédures et fonctions - scanf
Langage de programmation - C - Référence de procédures et fonctions - sscanf

Références

Langage C, Edition Micro-Application, Gehard Willms, 2001, ISBN: 2-7429-2008-0, page 734.
Borland C++ for Windows 4.0, Library Reference, Edition Borland, 1993, Part # BCP1240WW21772, page 250.