Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::locale — regras de localização

std::locale, de <locale>, contém um conjunto de facetas que definem regras como a notação numérica, a classificação de caracteres e a ordenação de texto. Atribua-o a um fluxo com imbue() para escolher explicitamente as respetivas regras.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

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

std::locale, de <locale>, representa um conjunto de facetas: objetos que fornecem regras de localização. As categorias abrangem números, caracteres, ordenação de texto, datas e horas, valores monetários e mensagens. A simples criação de um objeto não altera as definições de um fluxo existente.

std::locale() copia as atuais definições globais de C++, enquanto std::locale::classic() fornece as regras imutáveis da localização clássica "C". O construtor que recebe um nome seleciona uma localização com nome; para além de "C" e "", os nomes suportados dependem da implementação. Um nome inválido provoca std::runtime_error, pelo que não deve presumir que a localização de um país específico está disponível.

Chame stream.imbue(loc) para atribuir uma localização a esse fluxo. No exemplo, std::locale::classic() garante um ponto decimal e a ausência de agrupamento dos algarismos; std::fixed e std::setprecision(2) definem dois algarismos depois do ponto. O resultado é 1234.50 seguido de uma mudança de linha, sem depender das localizações com nome instaladas.

std::locale::global(loc) altera a localização usada por futuras chamadas a std::locale(); para um objeto com nome, também chama setlocale(LC_ALL, loc.name().c_str()). Trata-se de uma alteração global, pelo que deve preferir imbue() para formatação isolada. Esta entrada refere-se a C++23; o projeto de norma citado continua a evoluir e o exemplo requer verificação local — a compatibilidade com um ambiente de execução de produção não está certificada.

Exemplos

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

Resultado

1234.50

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes