C-Bibliotheksfunktion -newlocale()

C-Standardbibliothek - <locale.h>

Beschreibung

newlocale()ist eine Funktion in der C-Standardbibliothek, die zum Erstellen eines neuen Locale-Objekts verwendet wird. Diese Funktion ermöglicht es dem Programm, eine bestimmte Locale-Einstellung zu erstellen, und kann basierend auf einem vorhandenen Locale geändert oder erweitert werden.

Deklaration

Nachfolgend die Deklaration der Funktion newlocale().

#include <locale.h>

locale_t newlocale(int category_mask, const char *locale, locale_t base);

Parameter

  • category_mask: Eine Maske aus einer oder mehreren festzulegenden Locale-Kategorien. Sie kann eine Kombination der folgenden Makros sein (über den bitweisen OR-Operator|Kombination):

    • LC_COLLATE_MASK: Lokalisierungsinformationen bezogen auf den Zeichenfolgenvergleich.
    • LC_CTYPE_MASKLokalisierungsinformationen bezogen auf Zeichenklassifizierung und -konvertierung.
    • LC_MONETARY_MASK: Lokalisierungsinformationen bezogen auf das Währungsformat.
    • LC_NUMERIC_MASK: Lokalisierungsinformationen bezogen auf das Zahlenformat.
    • LC_TIME_MASK: Lokalisierungsinformationen bezogen auf das Zeitformat.
    • LC_MESSAGES_MASK: Lokalisierungsinformationen im Zusammenhang mit der Anzeige von Meldungen.
    • LC_ALL_MASKAlle Lokalisierungskategorien.
  • locale: Eine Zeichenkette, die den Namen des festzulegenden Locales angibt (z. B. "en_US.UTF-8"). Wenn sieNULLDann wird das Standard-Locale verwendet.

  • base: ein vorhandeneslocale_tObjekt, das als Grundlage für die Erstellung eines neuen Locale-Objekts verwendet wird. Wenn esNULLDann wird ein neues Objekt von Grund auf neu erstellt.

Rückgabewert

  • Bei Erfolg wird das neu erstellte Locale-Objekt zurückgegeben (Typlocale_t)。
  • Bei einem Fehler wird zurückgegebenNULL。

Beispiel

Der folgende Code ist ein Beispiel für das Erstellen und Verwenden eines neuen Locale-Objekts mit newlocale():

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;
    }

    // Das Locale-Objekt des aktuellen Threads auf das neue Locale-Objekt setzen
    locale_t oldloc = uselocale(newloc);

    // Aktuelle Locale-Informationen abrufen und ausgeben
    struct lconv *lc = localeconv();
    printf("Dezimaltrennzeichen im neuen Locale: %s\n", lc->decimal_point);
    printf("Tausendertrennzeichen im neuen Locale: %s\n", lc->thousands_sep);

    // Das vorherige Locale-Objekt wiederherstellen
    uselocale(oldloc);

    // Das neue Locale-Objekt freigeben
    freelocale(newloc);

    return 0;
}

Lassen Sie uns das obige Programm kompilieren und ausführen, was das folgende Ergebnis erzeugt:

Decimal point character in new locale: .
Thousands separator in new locale: ,

Code-Erklärung

Ein neues Locale-Objekt erstellen

  • newlocale(LC_ALL_MASK, "en_US.UTF-8", NULL): Ein neues Locale-Objekt erstellen, unter Verwendung des Locales "en_US.UTF-8", basierend auf dem Standard-Locale-Objekt.
  • newlocale(LC_NUMERIC_MASK | LC_TIME_MASK, "fr_FR.UTF-8", NULL): Ein neues Locale-Objekt erstellen, wobei numerische und Zeitformate auf "fr_FR.UTF-8" (Französisch - Frankreich) gesetzt werden und andere Kategorien die Standardeinstellungen verwenden.

Das Thread-Locale-Objekt festlegen

  • Nutzunguselocale(newloc)Das Locale-Objekt des aktuellen Threads auf das neu erstellte Locale-Objekt setzen.
  • Nutzunguselocale(oldloc)Das vorherige Locale-Objekt wiederherstellen.

Gibt das Lokalisierungsobjekt frei

  • Nutzungfreelocale(newloc)Das neu erstellte Locale-Objekt freigeben, um Speicherlecks zu vermeiden.

Hinweise

  • newlocale()ist Teil des POSIX.1-2008-Standards und wird nicht auf allen Plattformen unterstützt. Bei Verwendung der GNU-C-Bibliothek unbedingt einbinden<xlocale.h>Header-Datei.
  • newlocale()zurückgegebenlocale_tDas Objekt kann übergeben werden anuselocale()Funktion, um vorübergehend ein anderes Locale in einem Thread zu verwenden.

Zusammenfassung

newlocale()Funktion ermöglicht das Erstellen und Verwenden neuer Locale-Objekte, sodass Programme verschiedene Locale-Einstellungen und Lokalisierungsanforderungen handhaben können. Durch Kombinierennewlocale()、uselocale()undfreelocale()Mit dieser Funktion können Programmierer die Lokalisierungsinformationen des Programms flexibler verwalten und umschalten und dadurch die Entwicklung internationalisierter Anwendungen unterstützen.

C-Standardbibliothek - <locale.h>

Weitere Erweiterungen