STRERROR

Syntaxe

Paramètres

Description

Cette fonction pointe sur le message d'erreur correspondant à «noerr».

Remarques

• La fonction strerror() renvoie un pointeur sur une chaîne de caractères définie par la mise en oeuvre associée à la valeur de noerr.
• ATTENTION ! Vous ne devez en aucun cas modifier la chaîne de caractères car vous risquez de faire planter votre programme ou créer une instabilité de système.
• Si vous souhaitez signaler un erreur au niveau de l'analyse du préprocesseur du compilateur, vous devez plutôt utiliser la directive de compilation «#error».
• Utilisation typique pour afficher des messages d'erreur : strerror est couramment utilisée pour afficher des messages d'erreur lorsqu'une fonction standard échoue et définit errno. Exemple :
  1. #include <iostream>
  2. #include <cerrno>
  3. #include <cstring>
  4.  
  5. int main() {
  6.     FILE* file = fopen("fichier_inexistant.txt", "r");
  7.     if (!file) {
  8.         std::cout << "Erreur : " << strerror(errno) << std::endl;
  9.     }
  10. }

  Si le fichier n'existe pas, cela affiche :

  No such file or directory

  
  
• Retourne une chaîne statique partagée : strerror retourne un pointeur vers une chaîne statique, ce qui signifie que son contenu peut être écrasé lors d'un autre appel. Exemple :
  1. char* err1 = strerror(ENOENT);
  2. char* err2 = strerror(EACCES);
  3. std::cout << err1 << std::endl; // Peut être modifié après l'appel suivant
  4. std::cout << err2 << std::endl;

  Pour éviter tout conflit, il faut copier la valeur si on veut la conserver.

• Ne prend pas en charge les erreurs personnalisées : strerror ne permet d'afficher que les erreurs standard du système définies par errno.h. Si une application a des codes d'erreur personnalisés, il faut utiliser une autre approche, comme un tableau de messages d'erreur personnalisés.
• Alternative plus sûre : strerror_r (POSIX) et std::strerror_s (C11) : strerror n'est pas thread-safe, car elle utilise une chaîne de caractères statique partagée. Les versions sûres sont :

strerror_r(int errnum, char* buf, size_t buflen)	POSIX
std::strerror_s(char* buf, size_t buflen, int errnum)	C11

Exemple avec strerror_r :

1. char buffer[256];
2. strerror_r(errno, buffer, sizeof(buffer));
3. std::cout << buffer << std::endl;


• Ne fonctionne que sur les codes d'erreur connus : Si on passe un code d'erreur inexistant ou non supporté, strerror renvoie un message générique ou un comportement indéfini, selon l'implémentation. Exemple :
  1. std::cout << strerror(9999) << std::endl;

  Cela peut afficher un message par défaut comme "Unknown error" ou produire un résultat erroné.

• Différences entre systèmes d'exploitation : Le texte retourné par strerror peut varier selon le système d'exploitation et l'implémentation de la bibliothèque standard. Par exemple, une erreur EACCES (permission refusée) peut donner :

  Permission denied	Sur Linux
  Permission refused	Sur Windows

  Cela peut poser des problèmes pour les programmes multi-plateformes.

• Peut être remplacée par std::system_category en C++ moderne : En C++ moderne, la bibliothèque <system_error> offre une alternative plus propre avec std::system_category(). Exemple :
1. #include <iostream>
2. #include <system_error>
3.  
4. int main() {
5.     std::error_code ec(ENOENT, std::system_category());
6.     std::cout << ec.message() << std::endl;
7. }

Cette approche est plus portable et sécurisée que strerror.

Exemple

Voici quelques exemples de valeur que retourne cette fonction :

Essayer maintenant !

on obtiendra le résultat semblable suivant :

Voir également

Langage de programmation - C++ - Référence de procédures et fonctions - perror
Langage de programmation - C - Référence de procédures et fonctions - strerror

Références

Langage C, Edition Micro-Application, Gehard Willms, 2001, ISBN: 2-7429-2008-0, page 734.
Borland C++ for Windows 4.0, Library Reference, Edition Borland, 1993, Part # BCP1240WW21772, page 257.