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

CKTIS / C

setlocale — selecionar ou consultar as definições de região

setlocale seleciona ou consulta as definições de região da biblioteca C, que afetam, entre outros aspetos, a formatação de números.

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

Sintaxe

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

setlocale, de <locale.h>, altera as definições de região do programa. category seleciona uma parte; LC_ALL abrange todas. LC_NUMERIC controla, entre outras coisas, o carácter separador decimal.

"C" seleciona o ambiente C mínimo e "", o ambiente nativo; os outros nomes dependem da implementação. Os programas começam em "C". Passar NULL consulta as definições sem as alterar. Se a alteração falhar, é devolvido NULL e as definições mantêm-se inalteradas.

Não modifiques a cadeia devolvida. Se precisares dela, copia-a antes da chamada seguinte: a utilização posterior do valor devolvido tem comportamento indefinido, também depois de terminar a thread que fez a chamada. As chamadas podem causar data races com operações dependentes das definições de região.

Exemplos

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

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

    printf("%.2f\n", 1234.5);
    return 0;
}

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