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.