Gebietsschema
Das Gebietsschema bezieht sich auf die Einstellungen für das Land bzw. die Region und die 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 einige oder alle aktuellen Programm- oder Threadgebietsschemainformationen zu ändern oder abzufragen, während Sie Funktionen ohne das _l Suffix verwenden. 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 für die Verwendung mit einer Funktion mit einem _l Suffix zu erstellen, verwenden Sie _create_locale. Verwenden Sie _free_localezum Freigeben dieses Gebietsschemas . Verwenden Sie _get_current_localezum Abrufen des aktuellen Gebietsschemas .
Hier können Sie _configthreadlocale steuern, ob jeder Thread über ein eigenes Gebietsschema verfügt oder ob alle Threads in einem Programm dasselbe Gebietsschema aufweisen. Weitere Informationen finden Sie unter Gebietsschemas und Codeseiten.
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 Sicherheitsfeatures im CRT.
Gebietsschemaabhängige Routinen
| Routine | Zweck | 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, isw-Routinen |
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 Byte eines beliebigen Multibyte-Zeichens im aktuellen Gebietsschema (Makro definiert in STDLIB.H) |
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_l_strlwr_s, , _mbslwr_s, , , _wcslwr_s_mbslwr_s_l_wcslwr_s_l |
Konvertieren von jedem Großbuchstaben in angegebener Zeichenfolge in Kleinbuchstaben an jeweiliger Stelle | LC_CTYPE |
strtod, , _strtod_lwcstod_wcstod_l |
Konvertieren von Zeichenfolge in double-Wert |
LC_NUMERIC (bestimmt die Basiszeichenerkennung) |
strtol, , wcstol_strtol_l_wcstol_l |
Konvertieren von Zeichenfolge in long-Wert |
LC_NUMERIC (bestimmt die Basiszeichenerkennung) |
strtoul, , _strtoul_lwcstoul_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_l_strupr_s, , _mbsupr_s, , , _wcsupr_s_mbsupr_s_l_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_l_mbctolower, , , _mbctoupper_mbctoupper_l |
Konvertieren von angegebenem Zeichen zu entsprechendem Kleinbuchstaben | LC_CTYPE |
toupper, _toupper, , towupper, _toupper_l, _towupper_l, _mbctolower_l_mbctolower, , , _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-Codeseite dem Gebietsschema entsprechen, mit setlocaledem das Gebietsschema festgelegt ist. _setmbcp, mit einem Argument, dass _MB_CP_LOCALE die Multibyte-Codeseite mit der setlocale Codeseite identisch ist.
Siehe auch
Internationalisierung
Universelle C-Laufzeitroutinen nach Kategorie