CKTIS / C
setlocale — wybór lub odczyt ustawień regionalnych
setlocale wybiera lub odczytuje ustawienia regionalne biblioteki C, wpływające między innymi na formatowanie liczb.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <locale.h>
char *setlocale(int category, const char *locale);setlocale z <locale.h> zmienia ustawienia regionalne programu. category wybiera ich część; LC_ALL obejmuje całość. LC_NUMERIC steruje między innymi separatorem dziesiętnym.
"C" wybiera minimalne środowisko C, "" — środowisko natywne; inne nazwy zależą od implementacji. Program rozpoczyna działanie w "C". Argument NULL odczytuje ustawienia bez zmiany. Nieudana zmiana zwraca NULL, zachowując dotychczasowe ustawienia.
Zwróconego napisu nie wolno modyfikować. Przed kolejnym wywołaniem skopiuj go, jeśli będzie potrzebny: późniejsze użycie zwróconej wartości jest niezdefiniowane, również po zakończeniu wątku wywołującego. Wywołania mogą powodować wyścigi danych z operacjami zależnymi od ustawień regionalnych.
Przykłady
#include <locale.h>
#include <stdio.h>
int main(void)
{
if (setlocale(LC_NUMERIC, "C") == NULL) {
return 1;
}
printf("%.2f\n", 1234.5);
return 0;
}
Wynik
1234.50
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.