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

CKTIS / C

strerror — décrire un code d’erreur

strerror convertit un code d’erreur en message. Le texte renvoyé dépend de l’implémentation et de la locale.

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

Syntaxe

#include <string.h>
char *strerror(int errnum);

strerror(errnum) de <string.h> renvoie un message pour toute valeur de type int, généralement obtenue à partir de errno. La fonction décrit un code ; elle ne détecte pas l’échec d’une opération.

Malgré le type de retour char *, ne modifiez pas le tableau renvoyé. Un appel ultérieur à strerror peut écraser le contenu du tableau. N’utilisez pas le pointeur renvoyé après la fin du thread qui l’a obtenu. Si vous avez besoin du texte après un autre appel ou après la fin de ce thread, copiez-le au préalable.

Des appels concurrents peuvent provoquer des courses de données. Ne présumez pas d’une formulation précise du message. L’exemple transmet EDOM sans provoquer volontairement d’erreur.

Exemples

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

int main(void)
{
    const char *message = strerror(EDOM);
    printf("message_available=%d\n", message != NULL && message[0] != '\0');
    return 0;
}

Résultat

message_available=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