SETLOCALE

Syntaxe

Paramètres

Description

Cette fonction permet de modifier des requêtes sur les paramètres régionales locale du programme.

Remarques

• La fonction setlocale() permet d'interroger ou de définir certains paramètres sensibles à l'environnement géopolitique de l'exécution d'un programme. Si locale est null, la fonction setlocale() renvoie un pointeur sur la chaîne de caractères de localisation actuelle. Sinon, la fonction setlocale() tente d'utiliser la chaîne de caractères spécifiée par locale pour définir les paramètres de locale spécifiés par category.
• La fonction setlocale() renvoie un pointeur sur une chaîne associée au paramètre category.
• Définition et utilité : La fonction setlocale fait partie de la bibliothèque <clocale> en C++ et <locale.h> en C. Elle permet de configurer les paramètres régionaux (locale) d'un programme, influençant ainsi le comportement de certaines fonctions liées à l'affichage des nombres, à la gestion des caractères et au tri de chaînes de caractères.
• Valeur de retour et vérification : setlocale retourne un pointeur vers la chaîne indiquant la locale actuellement utilisée. Si la locale spécifiée est invalide ou non supportée, la fonction retourne NULL. Il est important de toujours vérifier la valeur de retour pour éviter des erreurs. Exemple :
1. if (setlocale(LC_ALL, "es_ES.utf8") == NULL) {
2.     std::cerr << "Échec de la définition de la locale !" << std::endl;
3. }


• Utilisation de "C" et "" comme valeurs spéciales : "C" (ou NULL) : Définit la locale par défaut du C standard, indépendante de la langue de l'utilisateur. "" (chaîne vide) : Adapte automatiquement la locale en fonction des paramètres régionaux du système. Exemple :
1. setlocale(LC_ALL, "C");  // Utilise la locale par défaut du langage C
2. setlocale(LC_ALL, "");   // Utilise la locale du système


• Impact sur les fonctions standard : setlocale influence plusieurs fonctions standard de C et C++, notamment :

Fonction	Description
printf et scanf	Affecte le format des nombres flottants (, ou .).
strftime	Modifie le format des dates et heures.
tolower et toupper	Dépendent de LC_CTYPE pour le traitement des caractères spéciaux.
strcoll et strxfrm	Utilisent LC_COLLATE pour comparer et trier les chaînes de manière spécifique à la langue.



• Compatibilité et dépendance au système : La disponibilité des locales dépend du système d'exploitation. Certaines locales peuvent ne pas être supportées sur Windows mais fonctionner sous Linux ou macOS. Sur certains systèmes Unix/Linux, la commande locale -a permet de lister les locales disponibles. Sous Windows, les locales utilisent souvent des noms légèrement différents, comme "French_France.1252" au lieu de "fr_FR.utf8".
• Utilisation avec std::locale en C++ moderne : En C++ moderne, il est souvent préférable d'utiliser la classe std::locale de la bibliothèque <locale> plutôt que setlocale, car elle offre une gestion plus fine et sûre des paramètres régionaux, notamment pour les flux d'entrée et sortie (std::cout, std::cin). Exemple :
1. #include <iostream>
2. #include <locale>
3.  
4. int main() {
5.     std::locale::global(std::locale("fr_FR.utf8"));
6.     std::cout.imbue(std::locale()); // Applique la locale aux flux
7.     std::cout << 1234.56 << std::endl;  // Affichera 1 234,56 en français
8.     return 0;
9. }

Exemple

Dans cette exemple, on définit la locale en français (fr_FR.utf8), ce qui influence le format des nombres et des dates :