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.