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

CKTIS / C++

std::locale — règles de localisation

std::locale, fourni par <locale>, contient un ensemble de facettes qui définissent notamment les règles d’écriture des nombres, de classification des caractères et de tri du texte. Affectez-le à un flux avec imbue() pour choisir explicitement ses règles.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <locale>
std::locale loc = std::locale::classic();
stream.imbue(loc);

std::locale, fourni par <locale>, représente un ensemble de facettes : des objets qui fournissent des règles de localisation. Les catégories couvrent les nombres, les caractères, le tri du texte, les dates et heures, les valeurs monétaires et les messages. La simple création d’un objet ne modifie pas les paramètres d’un flux existant.

std::locale() copie les paramètres globaux C++ actuels, tandis que std::locale::classic() fournit les règles immuables de la locale classique "C". Le constructeur qui prend un nom sélectionne une locale nommée ; en dehors de "C" et de "", les noms pris en charge dépendent de l’implémentation. Un nom invalide déclenche std::runtime_error : ne supposez donc pas que la locale d’un pays donné est disponible.

Appelez stream.imbue(loc) pour affecter une locale à ce flux. Dans l’exemple, std::locale::classic() garantit un point décimal et l’absence de groupement des chiffres ; std::fixed et std::setprecision(2) définissent deux chiffres après le point. Le résultat est 1234.50 suivi d’un retour à la ligne, sans dépendre des locales nommées installées.

std::locale::global(loc) modifie la locale utilisée par les futurs appels à std::locale() ; pour un objet nommé, elle appelle aussi setlocale(LC_ALL, loc.name().c_str()). Cette modification est globale : préférez donc imbue() pour un formatage isolé. Cette entrée porte sur C++23 ; le projet de norme cité continue d’évoluer, et l’exemple doit être vérifié localement — sa compatibilité avec un environnement d’exécution de production n’est pas attestée.

Exemples

#include <iomanip>
#include <iostream>
#include <locale>
#include <sstream>

int main() {
    std::ostringstream out;
    out.imbue(std::locale::classic());
    out << std::fixed << std::setprecision(2) << 1234.5;
    std::cout << out.str() << '\n';
}

Résultat

1234.50

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