WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen