C-Bibliotheksfunktionen -uselocale()
C-Standardbibliothek - <locale.h>
Beschreibung
uselocale()Es ist eine Funktion in der C-Standardbibliothek, mit der das aktuelle Locale-Objekt eines Threads festgelegt oder abgerufen wird. Diese Funktion ermöglicht es Programmen, unterschiedliche Locale-Einstellungen in verschiedenen Threads zu verwenden, wodurch die Lokalisierung in einer Multithread-Umgebung unterstützt wird.
Deklaration
Das Folgende ist die Deklaration der Funktion uselocale().
#include <locale.h> locale_t uselocale(locale_t newloc);
Parameter
newloc: als Locale-Objekt des aktuellen Threads festgelegt zu werden.locale_tObjekt.- Wenn es
LC_GLOBAL_LOCALE, dann wird die globale Locale verwendet. - Wenn es
NULL, dann wird das aktuelle Locale-Objekt nicht geändert, und nur das aktuelle Locale-Objekt wird zurückgegeben. - Andere gültige
locale_tDas Objekt wird als Locale-Objekt des aktuellen Threads festgelegt.
- Wenn es
Rückgabewert
- Gibt bei Erfolg das vorherige zurück
locale_tDas Objekt (das Locale-Objekt des aktuellen Threads). - Bei einem Fehler wird zurückgegeben
LC_GLOBAL_LOCALEund setzt den entsprechenden Fehlercode.
Beispiel
Das folgende Beispiel zeigt, wie freelocale() verwendet wird, um ein von newlocale() erstelltes Locale-Objekt freizugeben.
Beispiel
#include <locale.h>
#include <xlocale.h> // Erforderlich bei Verwendung von GNU-Erweiterungen
int main() {
// Ein neues Locale-Objekt erstellen, wobei die Locale-Einstellung "en_US.UTF-8" verwendet wird
locale_t newloc = newlocale(LC_ALL_MASK, "en_US.UTF-8", (locale_t)0);
if (newloc == (locale_t)0) {
perror("newlocale");
return 1;
}
// Aktuelle Locale-Informationen abrufen und ausgeben
struct lconv *lc = localeconv();
printf("Dezimaltrennzeichen der Standard-Locale: %s\n", lc->decimal_point);
printf("Tausendertrennzeichen der Standard-Locale: %s\n", lc->thousands_sep);
// Das Locale-Objekt des aktuellen Threads auf das neue Locale-Objekt setzen
locale_t oldloc = uselocale(newloc);
// Neue Lokalisierungsinformationen abrufen und ausgeben
lc = localeconv();
printf("Dezimaltrennzeichen der neuen Locale: %s\n", lc->decimal_point);
printf("Tausendertrennzeichen der neuen Locale: %s\n", lc->thousands_sep);
// Das vorherige Locale-Objekt wiederherstellen
uselocale(oldloc);
// Wiederhergestellte Lokalisierungsinformationen abrufen und ausgeben
lc = localeconv();
printf("Dezimaltrennzeichen der wiederhergestellten Locale: %s\n", lc->decimal_point);
printf("Wiederhergestelltes Tausendertrennzeichen der Locale: %s\n", lc->thousands_sep);
// Das neue Locale-Objekt freigeben
freelocale(newloc);
return 0;
}
Lassen Sie uns das obige Programm kompilieren und ausführen, was das folgende Ergebnis erzeugt:
Default locale decimal point: . Default locale thousands separator: New locale decimal point: . New locale thousands separator: , Restored locale decimal point: . Restored locale thousands separator:
Code-Erklärung
-
Ein neues Locale-Objekt erstellen:
- Nutzung
newlocale(LC_ALL_MASK, "en_US.UTF-8", (locale_t)0)Erstellen Sie ein neues Locale-Objekt und setzen Sie die Locale auf "en_US.UTF-8".
- Nutzung
-
Standard-Locale-Informationen ausgeben:
- Nutzung
localeconv()Rufen Sie die aktuellen Standard-Locale-Informationen ab und geben Sie sie aus, wie z. B. das Dezimaltrennzeichen und das Tausendertrennzeichen.
- Nutzung
-
Das Thread-Locale-Objekt festlegen:
- Nutzung
uselocale(newloc)Setzen Sie das Locale-Objekt des aktuellen Threads auf das neu erstellte Locale-Objekt und speichern Sie das vorherige Locale-Objekt.
- Nutzung
-
Neue Locale-Informationen ausgeben:
- Nutzung
localeconv()Rufen Sie die neuen Locale-Informationen ab und geben Sie sie aus, um zu überprüfen, ob der Wechsel erfolgreich war.
- Nutzung
-
Stellen Sie das vorherige Locale-Objekt wieder her:
- Nutzung
uselocale(oldloc)Das vorherige Locale-Objekt wiederherstellen.
- Nutzung
-
Geben Sie das Locale-Objekt frei:
- Nutzung
freelocale(newloc)Geben Sie das neu erstellte Locale-Objekt frei, um Speicherlecks zu vermeiden.
- Nutzung
Hinweise
uselocale()Die Funktion ist Teil des POSIX.1-2008-Standards; stellen Sie sicher, dass Ihre Plattform diese Funktion unterstützt.- Bei Verwendung in einer Multithread-Umgebung
uselocale()Sie können für jeden Thread ein unabhängiges Locale-Objekt festlegen, aber achten Sie auf Datenkonsistenz und Race Conditions zwischen Threads. - Nutzung
freelocale()Geben Sie nicht mehr benötigte Locale-Objekte frei, um Speicherlecks zu vermeiden.
Zusammenfassung
uselocale()Die Funktion ermöglicht das Festlegen und Abrufen des Locale-Objekts des aktuellen Threads und ermöglicht dadurch Lokalisierungsunterstützung in Multithread-Umgebungen. Durch die Kombination der Verwendung vonnewlocale()、uselocale()undfreelocale()Funktion können Programmierer die Locale-Einstellungen des Programms flexibel verwalten und wechseln und so unabhängige Locale-Unterstützung für verschiedene Threads bereitstellen.