Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] strerror, strerror_r - Obtenir le libellé d'un code d'erreur. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <string.h>[/b] [b][i]char strerror (int errnum );[/i][/b] [b][/b] [b][i]int strerror_r(int errnum , char buf , size_t n );[/i][/b] .fi [size=18] [b]Description[/b] [/size] La fonction [b]strerrror()[/b] renvoie une chaîne décrivant le code d'erreur passé en argument [b]errnum ,[/b] en utilisant éventuellement la catégorie LC_MESSAGES de la localisation pour sélectionner la langue appropriée. Cette chaîne ne doit pas être modifiée par l'application, mais peut être écrasée par un appel ultérieur à [b]perror()[/b] ou [b]strerror() .[/b] Aucune autre fonction de bibliothèque ne modifie cette chaîne. La fonction [b]strerror_r()[/b] est identique à [b]strerror()[/b] mais fonctionne correctement dans un environnement multi-threads, puisqu'elle renvoie la chaîne dans le buffer [i]buf[/i] de longueur [i]n[/i] fourni par l'appelant. [size=18] [b]Valeur renvoyée[/b] [/size] La fonction [b]strerror()[/b] renvoie la description correspondant au code transmis, ou un message d'erreur inconnue si le code n'existe pas. La valeur de [i]errno[/i] n'est pas modifiée lors des appels réussi, mais contient une valeur non-nulle en cas d'erreur. La fonction [b]strerror_r()[/b] renvoie 0 si elle réussit et -1 sinon, en remplissant [i]errno[/i]. [size=18] [b]Erreurs[/b] [/size] [b]EINVAL[/b] [table][row][col]    [/col][col]La valeur de [i]errnum[/i] n'est pas un code d'erreur valide.[/col][/row][/table] [b]ERANGE[/b] [table][row][col]    [/col][col]Le buffer fourni n'est pas assez grand. [/col][/row][/table] [size=18] [b]Conformité[/b] [/size] SVID 3, POSIX, BSD 4.3, ISO/IEC 9899:1990 (C89). La fonction [b]strerror_r ()[/b] avec le prototype décrit ci-dessus est spécifiée par SUSv3, et était utilisée sous Digital Unix et HP Unix. Une fonction incompatible, avec le prototype [b][i]char strerror_r(int errnum , char buf , size_t n );[/i][/b] était une extension GNU utilisée par la GlibC, et doit être considérée comme obsolète en regard de SUS v3. La version GNU pouvait, sans y être obligée, utiliser le buffer fourni par l'utilisateur. Si elle le faisait, le résultat pouvait être tronqué si le buffer était trop petit. Le résultat était toujours terminé par un NUL. [size=18] [b]Voir aussi[/b] [/size] [b]errno (3),[/b] [b]perror (3),[/b] [b]strsignal (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier