CKTIS / C++
std::locale — Lokalisierungsregeln
std::locale aus <locale> enthält eine Sammlung von Facetten, die Regeln etwa für Zahlenschreibweisen, Zeichenklassifizierung und Textsortierung festlegen. Weise das Objekt mit imbue() einem Stream zu, um dessen Regeln ausdrücklich auszuwählen.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <locale>
std::locale loc = std::locale::classic();
stream.imbue(loc);std::locale aus <locale> steht für eine Sammlung von Facetten: Objekten, die Lokalisierungsregeln bereitstellen. Die Kategorien umfassen Zahlen, Zeichen, Textsortierung, Datum und Uhrzeit, Geld sowie Meldungen. Allein durch das Erzeugen eines Objekts ändern sich die Einstellungen eines bestehenden Streams nicht.
std::locale() kopiert die aktuellen globalen C++-Einstellungen, während std::locale::classic() die unveränderlichen Regeln des klassischen Gebietsschemas "C" bereitstellt. Der Konstruktor mit Namen wählt ein benanntes Gebietsschema aus; abgesehen von "C" und "" sind die unterstützten Namen implementationsabhängig. Ein ungültiger Name löst std::runtime_error aus. Gehe daher nicht davon aus, dass das Gebietsschema eines bestimmten Landes verfügbar ist.
Rufe stream.imbue(loc) auf, um einem Stream ein Gebietsschema zuzuweisen. Im Beispiel sorgt std::locale::classic() für einen Dezimalpunkt und dafür, dass Ziffern nicht gruppiert werden; std::fixed und std::setprecision(2) legen zwei Nachkommastellen fest. Das Ergebnis ist 1234.50 gefolgt von einem Zeilenumbruch, unabhängig davon, welche benannten Gebietsschemas installiert sind.
std::locale::global(loc) ändert das Gebietsschema, das bei künftigen Aufrufen von std::locale() verwendet wird; bei einem benannten Objekt ruft es außerdem setlocale(LC_ALL, loc.name().c_str()) auf. Das ist eine globale Änderung. Verwende daher für isolierte Formatierung bevorzugt imbue(). Dieser Eintrag bezieht sich auf C++23; der zitierte Arbeitsentwurf wird weiterentwickelt, und das Beispiel muss lokal überprüft werden — die Kompatibilität mit einer Produktionslaufzeit ist nicht bestätigt.
Beispiele
#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';
}
Ergebnis
1234.50
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.