Bibliothèque standard C -<assert.h>
Introduction
de la bibliothèque standard Cassert.hLe fichier d'en-tête en fournit une appeléeassertLa macro peut être utilisée pour vérifier les hypothèses faites par le programme et afficher des messages de diagnostic lorsque l'hypothèse est fausse.
La bibliothèque standard assert.h est principalement utilisée pour les assertions pendant l'exécution du programme. Une assertion est une méthode de test d'hypothèses, généralement utilisée pendant la phase de débogage, afin de détecter immédiatement les problèmes lorsque le programme entre dans un état inattendu.
<assert.h>Le mécanisme d'assertion fourni est un outil utile en langage C, aidant les développeurs à découvrir et corriger les erreurs dans les programmes à un stade précoce.
Macros définiesassertpointe vers une autre macroNDEBUG, macroNDEBUGIl ne fait pas partie de <assert.h>. Si NDEBUG est défini comme nom de macro dans le fichier source qui référence <assert.h>, alorsassertLa macro est définie comme suit :
assert(expression)
La macro assert est utilisée pour tester si l'expression expression est vraie. Si expression est fausse (c'est-à-dire que le résultat est 0), assert affiche un message d'erreur et termine l'exécution du programme. Le message d'erreur comprend les éléments suivants :
- L'expression qui déclenche l'échec de l'assertion
- nom du fichier source
- numéro de ligne
Dans les versions de production, toutes les assertions assert peuvent être désactivées en définissant NDEBUG. Par exemple :
#define NDEBUG #include <assert.h>
Une fois NDEBUG défini, la macro assert sera prétraitée en une instruction vide, sans surcoût à l'exécution.
Voici un exemple simple démontrant l'utilisation de base de assert :
Exemple
#include <assert.h>
void test_positive(int x) {
assert(x > 0);
}
int main() {
int a = 5;
int b = -3;
test_positive(a); // Cette assertion réussit
test_positive(b); // Cette assertion échoue, le programme se termine
printf("Cette ligne ne sera pas exécutée si une assertion échoue.\n");
return 0;
}
Dans l'exemple ci-dessus, lors de l'appel à test_positive(b), comme b est un nombre négatif, l'assertion x > 0 échouera, et le programme affichera des informations similaires à ce qui suit et se terminera :
Assertion failed: (x > 0), file example.c, line 6
Objectif des assertions
- Débogage: Pendant la phase de développement, les assertions peuvent rapidement détecter des erreurs logiques dans le programme ou des situations où les hypothèses ne tiennent pas.
- Documentation: Les assertions peuvent servir de partie de la documentation, en décrivant les préconditions et postconditions des fonctions.
- Programmation défensive: Bien qu'il ne soit pas recommandé d'utiliser des assertions pour la vérification des paramètres dans le code de production, dans certains cas, les assertions peuvent servir de dernière ligne de défense.
Notes
- Performance: Dans le code sensible aux performances, les assertions peuvent ajouter une surcharge supplémentaire, en particulier lorsqu'elles sont appelées fréquemment. Par conséquent, les assertions sont généralement désactivées dans les versions de release.
- Gestion des erreurs: Les assertions ne doivent pas être utilisées pour gérer des conditions d'erreur qui sont attendues et récupérables. Les assertions sont plus souvent utilisées pour détecter les erreurs de programmation.
Macros de bibliothèque
Ce qui suit répertorie l'unique fonction définie dans le fichier d'en-tête assert.h :
| Numéro de série | Fonctions et descriptions |
|---|---|
| 1 | void assert(int expression) Il s'agit en fait d'une macro, et non d'une fonction, qui peut être utilisée pour ajouter des diagnostics dans les programmes C. |