Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::locale — reguły lokalizacji

std::locale z nagłówka <locale> przechowuje zestaw aspektów określających m.in. zapis liczb, klasyfikację znaków i porządek sortowania tekstu. Przypisz obiekt do strumienia przez imbue(), aby jawnie wybrać jego reguły.

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

Składnia

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

std::locale z nagłówka <locale> reprezentuje zestaw aspektów (facets), czyli obiektów udostępniających reguły lokalizacji. Kategorie obejmują liczby, znaki, porównywanie tekstu, daty i czas, pieniądze oraz komunikaty. Samo utworzenie obiektu nie zmienia ustawień istniejącego strumienia.

std::locale() kopiuje bieżące globalne ustawienia C++, natomiast std::locale::classic() udostępnia stałe reguły klasycznego ustawienia "C". Konstruktor z nazwą wybiera nazwane ustawienia; poza "C" i "" obsługiwane nazwy zależą od implementacji. Nieprawidłowa nazwa powoduje std::runtime_error, więc nie zakładaj dostępności ustawień konkretnego kraju.

Wywołaj stream.imbue(loc), aby przypisać ustawienia do danego strumienia. W przykładzie std::locale::classic() zapewnia kropkę dziesiętną i brak grupowania cyfr; std::fixed oraz std::setprecision(2) określają dwie cyfry po kropce. Wynik to 1234.50 i znak nowego wiersza, bez zależności od zainstalowanych nazwanych ustawień.

std::locale::global(loc) zmienia ustawienia używane przez przyszłe wywołania std::locale(); dla nazwanego obiektu wywołuje również setlocale(LC_ALL, loc.name().c_str()). To zmiana globalna, więc do izolowanego formatowania wybieraj imbue(). Zakres wpisu to C++23; cytowany roboczy standard rozwija się dalej, a przykład wymaga lokalnej weryfikacji — środowisko produkcyjne nie zostało potwierdzone.

Przykłady

#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';
}

Wynik

1234.50

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła