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 (Typ
locale_t)。 - Bei einem Fehler wird zurückgegeben
NULL。
Beispiel
Der folgende Code ist ein Beispiel für das Erstellen und Verwenden eines neuen Locale-Objekts mit newlocale():
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;
}
// 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
- Nutzung
uselocale(newloc)Das Locale-Objekt des aktuellen Threads auf das neu erstellte Locale-Objekt setzen. - Nutzung
uselocale(oldloc)Das vorherige Locale-Objekt wiederherstellen.
Gibt das Lokalisierungsobjekt frei
- Nutzung
freelocale(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.