CKTIS / C
setlocale — Gebietsschema auswählen oder abfragen
setlocale wählt die Gebietsschema-Einstellungen der C-Bibliothek aus oder fragt sie ab. Diese beeinflussen unter anderem die Formatierung von Zahlen.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <locale.h>
char *setlocale(int category, const char *locale);setlocale aus <locale.h> ändert das Gebietsschema des Programms. category wählt einen Teil davon aus; LC_ALL umfasst alle Einstellungen. LC_NUMERIC steuert unter anderem das Dezimaltrennzeichen.
"C" wählt die minimale C-Umgebung, "" die native Umgebung; andere Namen sind implementierungsabhängig. Programme beginnen mit "C". Mit NULL werden die Einstellungen abgefragt, ohne sie zu ändern. Eine fehlgeschlagene Änderung gibt NULL zurück und lässt die bisherigen Einstellungen unverändert.
Der zurückgegebene String darf nicht verändert werden. Wenn du ihn brauchst, kopiere ihn vor dem nächsten Aufruf: Die spätere Verwendung des zurückgegebenen Werts ist undefiniert, auch nachdem der aufrufende Thread beendet wurde. Aufrufe können Datenrennen mit gebietsschemaabhängigen Operationen verursachen.
Beispiele
#include <locale.h>
#include <stdio.h>
int main(void)
{
if (setlocale(LC_NUMERIC, "C") == NULL) {
return 1;
}
printf("%.2f\n", 1234.5);
return 0;
}
Ergebnis
1234.50
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.