Bibliothèque standard C -<errno.h>
Introduction
de la bibliothèque standard Cerrno.hLe fichier d'en-tête définit des variables entièreserrnoIl est positionné via des appels système ; en cas d'erreur, certaines fonctions de bibliothèque indiquent quelle erreur s'est produite. Cette macro se développe en une lvalue modifiable de type int, qui peut donc être lue et modifiée par un programme.
<errno.h>est un fichier d'en-tête de la bibliothèque standard C qui fournit un mécanisme pour signaler et gérer les erreurs dans les programmes. Ce fichier d'en-tête définit des macros et des variables pour indiquer et décrire les types d'erreurs d'exécution.
errno.hLe fichier d'en-tête définit une série de macros représentant différents codes d'erreur ; ces macros doivent s'étendre en expressions de typeintexpression constante entière.
errnoIl s'agit d'une variable globale utilisée pour stocker le code d'erreur le plus récent. Le type de cette variable estintLorsqu'une fonction de bibliothèque rencontre une erreur, elle définit généralementerrnopour indiquer le type d'erreur.
Par exemple, dans les opérations sur les fichiers, sifopenLorsqu'une fonction échoue parce que le fichier n'existe pas, elle définiraerrnoDéfini àENOENT。
Codes d'erreur courants
Voici quelques codes d'erreur courants ; ils sont<errno.h>définis comme macros dans :
EPERM: Opération non permiseENOENT: Aucun fichier ou dossier de ce typeESRCH: Aucun processus de ce typeEINTR: Appel système interrompuEIO: Erreur d'entrée/sortieENXIO: Aucun périphérique ou adresse de ce typeE2BIG: Liste d'arguments trop longueENOMEM: Mémoire insuffisanteEACCES: Permission refuséeEFAULT: Mauvaise adresseEBUSY: Ressource occupéeEEXIST: Le fichier existeEXDEV: Lien entre appareilsENODEV: Aucun périphérique de ce typeENOTDIR: N'est pas un répertoireEISDIR: Est un répertoireEINVAL: Argument invalideENFILE: Débordement de la table des fichiers systèmeEMFILE: Trop de fichiers ouvertsENOTTY: N'est pas un périphérique de terminalETXTBSY: Fichier texte occupéEFBIG: Fichier trop volumineuxENOSPC: Plus d'espace disponible sur le périphériqueESPIPE: Adressage illégalEROFS: Système de fichiers en lecture seuleEMLINK: Trop de liensEPIPE: Tube cassé
Exemples d’utilisation
Voici un exemple simple utilisant errno, montrant comment gérer les erreurs d'ouverture de fichier :
Exemple
#include <errno.h>
#include <string.h>
int main() {
FILE *file = fopen("nonexistent_file.txt", "r");
if (file == NULL) {
printf("Erreur lors de l'ouverture du fichier : %s\n", strerror(errno));
return 1;
}
// Code de traitement de fichier
fclose(file);
return 0;
}
Dans cet exemple, sifopenLa fonction échoue,errnosera défini sur le code d'erreur correspondant.strerrorLa fonction est utilisée pourerrnoconverti en un message d'erreur lisible par l'homme.
Notes
- Sécurité des threads: Dans les programmes multithread,
errnoIl est généralement implémenté sous forme de stockage local au thread (Thread-Local Storage, TLS) afin de garantir que chaque thread dispose d'un code d'erreur indépendant. - Valeur initialeEn cas d'appel réussi, les fonctions de bibliothèque ne modifient généralement pas
errnola valeur. Par conséquent, avant de vérifier l'erreur, vous devez vous assurererrnoest défini à 0. - Plage des codes d'erreurDifférents systèmes d'exploitation et implémentations de la bibliothèque standard C peuvent définir des codes d'erreur supplémentaires. Les programmes doivent éviter de dépendre des valeurs numériques de codes d'erreur spécifiques.
Recommandations de gestion des erreurs
- Vérifier la valeur de retourLors de l'appel d'une fonction susceptible d'échouer, vérifiez toujours sa valeur de retour.
- Paramètre
errnoest 0: Avant d'appeler une fonction, vous pouvez définirerrnodéfini à 0 afin qu'il puisse être vérifié après l'appel.errnos'il a été modifié. - Utilisation
strerror: viastrerrorvaerrnoLe convertir en une chaîne lisible pour faciliter le débogage et la journalisation.
En bref,<errno.h>Il fournit un moyen standardisé de signaler et de gérer les erreurs dans un programme, rendant le code de gestion des erreurs plus cohérent et plus facile à maintenir.
Macros de bibliothèque
Ce qui suit répertorie les macros définies dans le fichier d'en-tête errno.h:
| Numéro de série | Macro & Description |
|---|---|
| 1 | extern int errno Il s'agit d'une macro définie via des appels système ; lors d'événements d'erreur, certaines fonctions de bibliothèque indiquent quelle erreur s'est produite. |
| 2 | EDOM Erreur de domaine Cette macro représente une erreur de domaine, qui se produit lorsque l'argument d'entrée est en dehors du domaine défini par la fonction mathématique ; errno est défini à EDOM. |
| 3 | ERANGE Erreur d'intervalle Cette macro représente une erreur d'intervalle, qui se produit lorsque l'argument d'entrée dépasse l'intervalle défini par la fonction mathématique ; errno est défini à ERANGE. |