Freigeben über


Locale

Gebietsschema bezieht sich auf die Einstellungen für Land/Region und Sprache, mit denen Sie Ihr Programm anpassen können. Einige vom Gebietsschema abhängige Kategorien umfassen die Anzeigeformate für Datums- und Währungswerte. Weitere Informationen finden Sie unter Gebietsschemakategorien.

Verwenden Sie die setlocale-Funktion, um – bei der Verwendung von Funktionen ohne das _l-Suffix – einige oder alle Gebietsschemainformationen des aktuellen Programms oder Threads zu ändern oder abzufragen. Die Funktionen mit dem _l-Suffix verwenden den Gebietsschemaparameter, der nur während der Ausführung dieser spezifischen Funktion für ihre Gebietsschemainformation übergeben wird. Um ein Gebietsschema zu erstellen, das mit einer Funktion mit einem _l-Suffix verwendet werden kann, verwenden Sie _create_locale. Um dieses Gebietsschema freizugeben, verwenden Sie _free_locale. Rufen Sie das aktuelle Gebietsschema mithilfe von _get_current_locale ab.

Steuern Sie mithilfe von _configthreadlocale, ob jeder Thread über sein eigenes Gebietsschema verfügt, oder ob alle Threads in einem Programm das gleiche Gebietsschema verwenden. Weitere Informationen finden Sie unter Gebietsschemas und Codepages.

Von den Funktionen in der folgenden Tabelle sind sicherere Versionen verfügbar, die durch das Suffix _s ("sicher") gekennzeichnet sind. Weitere Informationen finden Sie unter Sicherheitsfunktionen in der CRT.

Gebietsschemaabhängige Routinen

Routine

Verwendung

Abhängig von setlocale-Kategorieneinstellungen

atof, _atof_l, _wtof, _wtof_l

Konvertieren von Zeichen in Gleitkommawert

LC_NUMERIC

atoi, _atoi_l, _wtoi, _wtoi_l

Konvertieren von Zeichen in ganzzahligen Wert

LC_NUMERIC

_atoi64, _atoi64_l, _wtoi64, _wtoi64_l

Konvertieren von Zeichen in 64-Bit-Ganzzahlwert

LC_NUMERIC

atol, _atol_l, _wtol, _wtol_l

Konvertieren von Zeichen in langen Wert

LC_NUMERIC

_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt _atoflt_l

Konvertieren von Zeichen in Wert mit doppelter Länge

LC_NUMERIC

is Routines

Testganzzahl für bestimmten Zustand.

LC_CTYPE

isleadbyte, _isleadbyte_l

Test für führendes Byte

LC_CTYPE

localeconv

Lesen von entsprechenden Werten zum Formatieren von numerischen Mengen

LC_MONETARY, LC_NUMERIC

MB_CUR_MAX

Maximale Länge in Bytes eines beliebigen Multibytezeichens im aktuellen Gebietsschema (in STDLIB.H per Makro definiert)

LC_CTYPE

_mbccpy, _mbccpy_l,_mbccpy_s, _mbccpy_s_l

Kopieren eines Multibytezeichens

LC_CTYPE

_mbclen, mblen, _mblen_l

Überprüfen und Zurückgeben einer Anzahl von Bytes in Multibytezeichen

LC_CTYPE

strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l

Bei Multibyte-Zeichenfolgen: Überprüfen jedes Zeichens in der Zeichenfolge; Zurückgeben der Zeichenfolgenlänge

LC_CTYPE

mbstowcs, _mbstowcs_l,mbstowcs_s, _mbstowcs_s_l

Konvertieren von Multibytezeichensequenz in entsprechende Breitzeichensequenz

LC_CTYPE

mbtowc, _mbtowc_l

Konvertieren von Multibytezeichen in entsprechendes Breitzeichen

LC_CTYPE

printf-Funktionen

Schreiben von formatierter Ausgabe

LC_NUMERIC (bestimmt die Basiszeichenausgabe)

scanf-Funktionen

Lesen von formatierter Eingabe

LC_NUMERIC (bestimmt die Basiszeichenerkennung)

setlocale, _wsetlocale

Auswählen von Gebietsschema für Programm

Nicht zutreffend

strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l

Vergleichen von Zeichen zweier Zeichenfolgen

LC_COLLATE

_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l

Vergleichen zweier Zeichenfolgen ohne Berücksichtigung von Groß-/Kleinbuchstaben

LC_CTYPE

_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l

Vergleichen von Zeichen zweier Zeichenfolgen (ohne Berücksichtigung von Groß-/Kleinbuchstaben)

LC_COLLATE

_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

Vergleichen der ersten n Zeichen von zwei Zeichenfolgen

LC_COLLATE

_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Vergleichen von Zeichen zweier Zeichenfolgen ohne Berücksichtigung von Groß-/Kleinbuchstaben.

LC_CTYPE

_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

Vergleichen der ersten n Zeichen zweier Zeichenfolgen (ohne Berücksichtigung von Groß-/Kleinbuchstaben)

LC_COLLATE

strftime, wcsftime, _strftime_l, _wcsftime_l

Formatieren von Datums- und Uhrzeitwert nach angegebenem format-Argument

LC_TIME

_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l,_strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l

Konvertieren von jedem Großbuchstaben in angegebener Zeichenfolge in Kleinbuchstaben an jeweiliger Stelle

LC_CTYPE

strtod, _strtod_l, wcstod, _wcstod_l

Konvertieren von Zeichenfolge in double-Wert

LC_NUMERIC (bestimmt die Basiszeichenerkennung)

strtol, wcstol, _strtol_l, _wcstol_l

Bekehrtzeichenfolge zu long-Wert

LC_NUMERIC (bestimmt die Basiszeichenerkennung)

strtoul, _strtoul_l, wcstoul, _wcstoul_l

Konvertieren von Zeichenfolge in langen Wert ohne Vorzeichen

LC_NUMERIC (bestimmt die Basiszeichenerkennung)

_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr,_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

Konvertieren von jedem Kleinbuchstaben in angegebener Zeichenfolge in Großbuchstaben an jeweiliger Stelle

LC_CTYPE

strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l

Transformieren von Zeichenfolge in sortierte Form gemäß Gebietsschema

LC_COLLATE

tolower, _tolower, towlower, _tolower_l, _towlower_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l

Konvertieren von angegebenem Zeichen zu entsprechendem Kleinbuchstaben

LC_CTYPE

toupper, _toupper, towupper, _toupper_l, _towupper_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l

Konvertieren von angegebenem Zeichen zu entsprechendem Großbuchstaben

LC_CTYPE

wcstombs, _wcstombs_l,wcstombs_s, _wcstombs_s_l

Konvertieren von Breitzeichensequenz in entsprechende Multibytezeichensequenz

LC_CTYPE

wctomb, _wctomb_l,wctomb_s, _wctomb_s_l

Konvertieren von Breitzeichen in entsprechendes Multibytezeichen

LC_CTYPE

Hinweis

Bei Multibyte-Routinen muss die Multibyte-Codepage dem mit setlocale festgelegten Gebietsschema entsprechen.Wenn _setmbcp über ein Argument von _MB_CP_LOCALE verfügt, ist die Multibyte-Codepage mit der setlocale-Codepage identisch.

Siehe auch

Referenz

Internationalisierung

Laufzeitroutinen nach Kategorie