std::setlocale

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Textverarbeitungsbibliothek

Lokalisierungsbibliothek

Reguläre Ausdrücke-Bibliothek (C++11)

Formatierungsbibliothek (C++20)

Dienstprogramme für Null-terminierte Sequenzen

Byte-Zeichenketten

Multibyte-Zeichenketten

Wide-Zeichenketten

Primitive numerische Konvertierungen

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

Textkodierungserkennung

text_encoding (C++26)

 

Lokalisierungsbibliothek

Lokale und Facetten   Lokale has_facet use_facet locale Facet-Kategorie Basisklassen ctype_base codecvt_base messages_base time_base money_base ctype-Facetten ctype ctype<char> ctype_byname codecvt codecvt_byname numerische Facetten num_get num_put numpunct numpunct_byname Kollationsfacetten collate collate_byname Zeitfacetten time_get time_put time_get_byname time_put_byname

Geldfacetten money_get money_put moneypunct moneypunct_byname Nachrichtenfacetten messages messages_byname Zeichenklassifizierung und -konvertierung Zeichenklassifizierung isspace    iscntrl isupper islower    isalpha ispunct isdigit    isxdigit isalnum isblank (C++11) isprint isgraph Zeichenkonvertierungen toupper    tolower String- und Streamkonvertierungen wstring_convert (C++11/17/26*) wbuffer_convert (C++11/17/26*) Unicode-Konvertierungsfacets codecvt_utf8 (C++11/17/26*) codecvt_utf16 (C++11/17/26*) codecvt_utf8_utf16 (C++11/17/26*) codecvt_mode (C++11/17/26*) C-Bibliotheks-Lokalisierungen LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME    setlocale localeconv lconv

 

Definiert in Header <clocale>
char* setlocale( int category, const char* locale );

Die Funktion setlocale installiert die angegebene Systemlokalisierung oder einen Teil davon als neue C-Lokalisierung. Die Änderungen bleiben bestehen und beeinflussen die Ausführung aller lokalisierungsabhängigen C-Bibliotheksfunktionen, bis zum nächsten Aufruf von setlocale. Wenn locale ein Nullzeiger ist, fragt setlocale die aktuelle C-Lokalisierung ab, ohne sie zu ändern.

Parameter

category	-	Lokalisierungskategorie-Identifikator, einer der Makros LC_xxx. Kann ​0​ sein.
locale	-	Systemspezifischer Lokalisierungsidentifikator. Kann "" für die vom Benutzer bevorzugte Lokalisierung oder "C" für die minimale Lokalisierung sein.

Rückgabewert

Zeiger auf eine schmale, nullterminierte Zeichenkette, die die C-Lokalisierung nach Anwendung der Änderungen identifiziert, oder ein Nullzeiger im Fehlerfall.

Eine Kopie der zurückgegebenen Zeichenkette kann zusammen mit der in diesem Aufruf von std::setlocale verwendeten Kategorie später im Programm verwendet werden, um die Lokalisierung in den Zustand vom Ende dieses Aufrufs zurückzusetzen.

Hinweise

Beim Programmstart wird die Entsprechung von std::setlocale(LC_ALL, "C"); ausgeführt, bevor irgendein Benutzercode läuft.

Obwohl der Rückgabetyp char* ist, ist die Änderung der zeigenden Zeichen undefiniertes Verhalten.

Da setlocale den globalen Zustand modifiziert, der die Ausführung lokalisierungsabhängiger Funktionen beeinflusst, ist es undefiniertes Verhalten, es von einem Thread aufzurufen, während ein anderer Thread eine der folgenden Funktionen ausführt: std::fprintf, std::isprint, std::iswdigit, std::localeconv, std::tolower, std::fscanf, std::ispunct, std::iswgraph, std::mblen, std::toupper, std::isalnum, std::isspace, std::iswlower, std::mbstowcs, std::towlower, std::isalpha, std::isupper, std::iswprint, std::mbtowc, std::towupper, std::isblank, std::iswalnum, std::iswpunct, std::setlocale, std::wcscoll, std::iscntrl, std::iswalpha, std::iswspace, std::strcoll, std::wcstod, std::isdigit, std::iswblank, std::iswupper, std::strerror, std::wcstombs, std::isgraph, std::iswcntrl, std::iswxdigit, std::strtod, std::wcsxfrm, std::islower, std::iswctype, std::isxdigit.

POSIX definiert auch eine Lokalisierung namens "POSIX", die immer zugänglich ist und exakt der Standard-Minimal-Lokalisierung "C" entspricht.

POSIX legt auch fest, dass der zurückgegebene Zeiger, nicht nur der Inhalt der zeigenden Zeichenkette, durch nachfolgende Aufrufe von setlocale ungültig werden kann.

Beispiel

Führen Sie diesen Code aus

#include <clocale>
#include <cstdio>
#include <ctime>
#include <cwchar>
#include <iterator>
#include <string>
 
int main()
{
    // Make a "deep copy" of current locale name.
    std::string prev_loc = std::setlocale(LC_ALL, nullptr);
 
    // The C locale will be UTF-8 enabled English,
    // decimal dot will be German,
    // date and time formatting will be Japanese.
    if (const char* loc = std::setlocale(LC_ALL, "en_US.UTF-8"))
        std::wprintf(L"New LC_ALL locale: %s\n", loc);
    if (const char* loc = std::setlocale(LC_NUMERIC, "de_DE.UTF-8"))
        std::wprintf(L"New LC_NUMERIC locale: %s\n", loc);
    if (const char* loc = std::setlocale(LC_TIME, "ja_JP.UTF-8"))
        std::wprintf(L"New LC_TIME locale: %s\n", loc);
 
    wchar_t buf[100];
    std::time_t t = std::time(nullptr);
    std::wcsftime(buf, std::size(buf), L"%A %c", std::localtime(&t));
    std::wprintf(L"Number: %.2f\nDate: %Ls\n", 3.14, buf);
 
    // Restore the previous locale.
    if (const char* loc = std::setlocale(LC_ALL, prev_loc.c_str()))
        std::wprintf(L"Restorred LC_ALL locale: %s\n", loc);
}

Mögliche Ausgabe

New LC_ALL locale: en_US.UTF-8
New LC_NUMERIC locale: de_DE.UTF-8
New LC_TIME locale: ja_JP.UTF-8
Number: 3,14
Date: 日曜日 2022年11月06日 20時40分59秒
Restorred LC_ALL locale: C

Siehe auch

LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	Lokalisierungskategorien für std::setlocale (Makrokonstante)
locale	Satz von polymorphen Facetten, die kulturelle Unterschiede kapseln (Klasse)
C-Dokumentation für setlocale

Externe Links

1.	Liste der Windows-Lokalisierungsnamen.
2.	Liste der Linux-Lokalisierungsnamen.