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 permise
  • ENOENT: Aucun fichier ou dossier de ce type
  • ESRCH: Aucun processus de ce type
  • EINTR: Appel système interrompu
  • EIO: Erreur d'entrée/sortie
  • ENXIO: Aucun périphérique ou adresse de ce type
  • E2BIG: Liste d'arguments trop longue
  • ENOMEM: Mémoire insuffisante
  • EACCES: Permission refusée
  • EFAULT: Mauvaise adresse
  • EBUSY: Ressource occupée
  • EEXIST: Le fichier existe
  • EXDEV: Lien entre appareils
  • ENODEV: Aucun périphérique de ce type
  • ENOTDIR: N'est pas un répertoire
  • EISDIR: Est un répertoire
  • EINVAL: Argument invalide
  • ENFILE: Débordement de la table des fichiers système
  • EMFILE: Trop de fichiers ouverts
  • ENOTTY: N'est pas un périphérique de terminal
  • ETXTBSY: Fichier texte occupé
  • EFBIG: Fichier trop volumineux
  • ENOSPC: Plus d'espace disponible sur le périphérique
  • ESPIPE: Adressage illégal
  • EROFS: Système de fichiers en lecture seule
  • EMLINK: Trop de liens
  • EPIPE: Tube cassé

Exemples d’utilisation

Voici un exemple simple utilisant errno, montrant comment gérer les erreurs d'ouverture de fichier :

Exemple

#include <stdio.h>
#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

  1. 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.
  2. Valeur initialeEn cas d'appel réussi, les fonctions de bibliothèque ne modifient généralement paserrnola valeur. Par conséquent, avant de vérifier l'erreur, vous devez vous assurererrnoest défini à 0.
  3. 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

  1. Vérifier la valeur de retourLors de l'appel d'une fonction susceptible d'échouer, vérifiez toujours sa valeur de retour.
  2. Paramètreerrnoest 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é.
  3. Utilisationstrerror: 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érieMacro & Description
1extern 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.
2EDOM 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.
3ERANGE 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.
autres extensions