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

CKTIS / C

<locale.h> — definições regionais

O cabeçalho <locale.h> fornece funções para selecionar definições regionais e obter informações sobre a formatação de números e quantias monetárias.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <locale.h>
char *setlocale(int category, const char *locale);
struct lconv *localeconv(void);

<locale.h> fornece setlocale e localeconv. A função localeconv devolve um ponteiro para uma estrutura do tipo struct lconv.

Categorias: LC_ALL — todas; LC_COLLATE — strcoll/strxfrm; LC_CTYPE — tratamento de caracteres e conversões multibyte; LC_MONETARY — informações monetárias; LC_NUMERIC — separador decimal e informações não monetárias; LC_TIME — strftime/wcsftime.

Em setlocale, "C" seleciona definições portáveis, "" o ambiente nativo e NULL consulta as definições atuais. Em caso de falha, devolve NULL sem alterar as definições. As alterações podem causar condições de corrida de dados.

Não modifique o resultado de localeconv; chamadas posteriores ou alterações relevantes das definições regionais podem substituí-lo.

Exemplos

#include <locale.h>
#include <stdio.h>

int main(void)
{
    if (setlocale(LC_ALL, "C") == NULL) {
        return 1;
    }

    const struct lconv *info = localeconv();
    printf("decimal_point=%s\n", info->decimal_point);
    printf("value=%.2f\n", 1234.5);
    return 0;
}

Resultado

decimal_point=.
value=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