Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::locale — regole di localizzazione

std::locale, definito in <locale>, contiene un insieme di facet che determinano regole quali la notazione dei numeri, la classificazione dei caratteri e l’ordinamento del testo. Assegnalo a uno stream con imbue() per sceglierne esplicitamente le regole.

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

Sintassi

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

std::locale, definito in <locale>, rappresenta un insieme di facet: oggetti che forniscono regole di localizzazione. Le categorie comprendono numeri, caratteri, ordinamento del testo, date e orari, valori monetari e messaggi. La semplice creazione di un oggetto non modifica le impostazioni di uno stream esistente.

std::locale() copia le attuali impostazioni globali di C++, mentre std::locale::classic() fornisce le regole immutabili della locale classica "C". Il costruttore che riceve un nome seleziona una locale denominata; a eccezione di "C" e "", i nomi supportati dipendono dall’implementazione. Un nome non valido genera std::runtime_error: non dare per scontato che sia disponibile la locale di un determinato paese.

Chiama stream.imbue(loc) per assegnare una locale a quello stream. Nell’esempio, std::locale::classic() garantisce il punto decimale e l’assenza di raggruppamento delle cifre; std::fixed e std::setprecision(2) impostano due cifre dopo il punto. Il risultato è 1234.50 seguito da un carattere di nuova riga, senza dipendere dalle locali denominate installate.

std::locale::global(loc) cambia la locale usata dalle chiamate future a std::locale(); se l’oggetto è denominato, chiama anche setlocale(LC_ALL, loc.name().c_str()). È una modifica globale, quindi preferisci imbue() per una formattazione isolata. Questa voce riguarda C++23; la bozza di lavoro citata continua a evolversi e l’esempio richiede una verifica locale: la compatibilità con un ambiente di esecuzione di produzione non è attestata.

Esempi

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

Risultato

1234.50

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti