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 esLC_GLOBAL_LOCALE, dann wird die globale Locale verwendet.
    • Wenn esNULL, dann wird das aktuelle Locale-Objekt nicht geändert, und nur das aktuelle Locale-Objekt wird zurückgegeben.
    • Andere gültigelocale_tDas Objekt wird als Locale-Objekt des aktuellen Threads festgelegt.

Rückgabewert

  • Gibt bei Erfolg das vorherige zurücklocale_tDas Objekt (das Locale-Objekt des aktuellen Threads).
  • Bei einem Fehler wird zurückgegebenLC_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 <stdio.h>
#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

  1. Ein neues Locale-Objekt erstellen:

    • Nutzungnewlocale(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".
  2. Standard-Locale-Informationen ausgeben:

    • Nutzunglocaleconv()Rufen Sie die aktuellen Standard-Locale-Informationen ab und geben Sie sie aus, wie z. B. das Dezimaltrennzeichen und das Tausendertrennzeichen.
  3. Das Thread-Locale-Objekt festlegen:

    • Nutzunguselocale(newloc)Setzen Sie das Locale-Objekt des aktuellen Threads auf das neu erstellte Locale-Objekt und speichern Sie das vorherige Locale-Objekt.
  4. Neue Locale-Informationen ausgeben:

    • Nutzunglocaleconv()Rufen Sie die neuen Locale-Informationen ab und geben Sie sie aus, um zu überprüfen, ob der Wechsel erfolgreich war.
  5. Stellen Sie das vorherige Locale-Objekt wieder her:

    • Nutzunguselocale(oldloc)Das vorherige Locale-Objekt wiederherstellen.
  6. Geben Sie das Locale-Objekt frei:

    • Nutzungfreelocale(newloc)Geben Sie das neu erstellte Locale-Objekt frei, um Speicherlecks zu vermeiden.

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-Umgebunguselocale()Sie können für jeden Thread ein unabhängiges Locale-Objekt festlegen, aber achten Sie auf Datenkonsistenz und Race Conditions zwischen Threads.
  • Nutzungfreelocale()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.

C-Standardbibliothek - <locale.h>

Weitere Erweiterungen