Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

<errno.h> — codes d’erreur

L’en-tête <errno.h> fournit errno et des macros de codes d’erreur. Interprétez-les selon le contrat de la fonction appelée.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <errno.h>

<errno.h> définit la macro errno : une l-value modifiable de type int dont la durée de stockage est liée au thread, et non une variable globale ordinaire. Ne désactivez pas cette macro et ne déclarez pas votre propre identificateur nommé errno.

EDOM, EILSEQ et ERANGE désignent respectivement les erreurs de domaine, d’encodage et d’intervalle. Ce sont des constantes positives distinctes de type int ; comparez leurs noms, pas leurs valeurs numériques.

Ne vérifiez errno que conformément au contrat de la fonction : une valeur non nulle ne prouve pas, à elle seule, qu’une erreur s’est produite. Si une remise à zéro est requise, définissez errno = 0 avant l’appel ; lisez ou sauvegardez le résultat avant tout autre appel de bibliothèque. Les fonctions de bibliothèque ne remettent pas automatiquement errno à zéro.

Exemples

#include <errno.h>
#include <stdio.h>

int main(void)
{
    errno = ERANGE;
    int saved_error = errno;
    errno = 0;
    int cleared = errno == 0;

    printf("saved ERANGE: %d\n", saved_error == ERANGE);
    printf("cleared: %d\n", cleared);
    return 0;
}

Résultat

saved ERANGE: 1
cleared: 1

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.

Sources