Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła