Helyszín

A területi beállítás azokat az ország-/régió- és nyelvi beállításokat jelenti, amelyekkel testre szabhatja a programot. Egyes területi beállításoktól függő kategóriák tartalmazzák a dátumok és a pénzügyi értékek megjelenítési formátumát. További információ: Területi kategóriák.

A függvény használatával setlocale módosíthatja vagy lekérdezheti az aktuális program vagy szál területi adatait, miközben az _l utótag nélküli függvényeket használja. Az utótaggal rendelkező _l függvények csak az adott függvény végrehajtása során használják a területi információikhoz átadott területi paramétert. Ha egy utótaggal rendelkező _l függvényhez szeretne területi beállításokat létrehozni, használja a következőt _create_locale: . A területi beállítás felszabadításához használja a következőt _free_locale: . Az aktuális területi beállítás lekéréséhez használja a következőt _get_current_locale: .

Annak szabályozására használható _configthreadlocale , hogy minden szál saját területi beállítással rendelkezik-e, vagy a program minden szála ugyanazzal a területi beállítással rendelkezik. További információ: Területi beállítások és kódlapok.

Az alábbi táblázatban található függvények biztonságosabb verziói érhetők el, amelyeket a _s "secure" utótag jelez. További információ: Biztonsági funkciók a CRT-ben.

Területi beállításoktól függő rutinok

Rutin	Használd	setlocale kategóriabeállítás függősége
atof, _atof_l, _wtof_wtof_l	Karakter átalakítása lebegőpontos értékké	LC_NUMERIC
atoi, _atoi_l, _wtoi_wtoi_l	Karakter átalakítása egész szám értékre	LC_NUMERIC
_atoi64, _atoi64_l, _wtoi64_wtoi64_l	Karakter konvertálása 64 bites egész szám értékre	LC_NUMERIC
atol, _atol_l, _wtol_wtol_l	Karakter átalakítása hosszú értékké	LC_NUMERIC
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l_atoflt_atoflt_l	Karakter konvertálása dupla hosszú értékre	LC_NUMERIC
is, isw rutinok	Adott állapot egész számának tesztelése.	LC_CTYPE
isleadbyte, _isleadbyte_l	Ólom bájtjának tesztelése	LC_CTYPE
localeconv	A numerikus mennyiségek formázásához szükséges értékek olvasása	LC_MONETARY, LC_NUMERIC
MB_CUR_MAX	Az aktuális területi beállításban szereplő bármely többbájtos karakter maximális hossza bájtban STDLIB.H(makró definiálva)	LC_CTYPE
_mbccpy, _mbccpy_l, _mbccpy_s_mbccpy_s_l	Többbájtos karakter másolása	LC_CTYPE
_mbclen, , mblen_mblen_l	Bájtok számának ellenőrzése és visszaadása többbájtos karakterben	LC_CTYPE
strlen, wcslen, _mbslen, _mbslen_l_mbstrlen_mbstrlen_l	Többbájtos sztringek esetén: ellenőrizze az egyes karaktereket a sztringben; sztringhossz visszaadva	LC_CTYPE
mbstowcs, _mbstowcs_l, mbstowcs_s_mbstowcs_s_l	Többbájtos karakterek sorozatának konvertálása széles karakterek megfelelő sorozatává	LC_CTYPE
mbtowc, _mbtowc_l	Többbájtos karakter átalakítása megfelelő széles karakterré	LC_CTYPE
printf függvények	Formázott kimenet írása	LC_NUMERIC (radix karakterkimenetet határoz meg)
scanf függvények	Formázott bemenet olvasása	LC_NUMERIC (radix karakterfelismerést határoz meg)
setlocale, _wsetlocale	Területi beállítás kiválasztása a programhoz	Nem alkalmazható
strcoll, wcscoll, _mbscoll, _strcoll_l_wcscoll_l_mbscoll_l	Két sztring karaktereinek összehasonlítása	LC_COLLATE
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l_wcsicmp_l_mbsicmp_l	Két sztring összehasonlítása a kis- és nagybetűk figyelembevételével	LC_CTYPE
_stricoll, _wcsicoll, _mbsicoll, _stricoll_l_wcsicoll_l_mbsicoll_l	Két sztring karaktereinek összehasonlítása (a kis- és nagybetűk érzéketlenek)	LC_COLLATE
_strncoll, _wcsncoll, _mbsncoll, _strncoll_l_wcsncoll_l_mbsncoll_l	Két sztring első n karaktereinek összehasonlítása	LC_COLLATE
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l_wcsnicmp_l_mbsnicmp_l	Két sztring karaktereinek összehasonlítása a kis- és nagybetűk figyelembevételével.	LC_CTYPE
_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l_wcsnicoll_l_mbsnicoll_l	Két sztring első n karaktereinek összehasonlítása (a kis- és nagybetűk nem érzékenyek)	LC_COLLATE
strftime, wcsftime, _strftime_l_wcsftime_l	Dátum- és időérték formázása a megadott format argumentum szerint	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	Az adott sztringben lévő nagybetűket a helyén kisbetűssé alakíthatja	LC_CTYPE
strtod, _strtod_l, wcstod_wcstod_l	Karaktersztring átalakítása értékké double	LC_NUMERIC (radix karakterfelismerést határoz meg)
strtol, wcstol, _strtol_l_wcstol_l	Karaktersztring átalakítása értékké long	LC_NUMERIC (radix karakterfelismerést határoz meg)
strtoul, _strtoul_l, wcstoul_wcstoul_l	Karaktersztring átalakítása aláíratlan hosszú értékké	LC_NUMERIC (radix karakterfelismerést határoz meg)
_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l_wcsupr, _strupr_s, _strupr_s_l, _mbsupr_s, , _mbsupr_s_l, _wcsupr_s, , _wcsupr_s_l	A sztringben lévő kisbetűket a helyén nagybetűssé alakíthatja	LC_CTYPE
strxfrm, wcsxfrm, _strxfrm_l_wcsxfrm_l	Sztring átalakítása rendezett formává a területi beállításoknak megfelelően	LC_COLLATE
tolower, _tolower, towlower, _tolower_l_towlower_l,_mbctolower , _mbctolower_l, , _mbctoupper_mbctoupper_l	Adott karakter átalakítása megfelelő kisbetűs karaktersé	LC_CTYPE
toupper, _toupper, towupper, _toupper_l_towupper_l,_mbctolower , _mbctolower_l, , _mbctoupper_mbctoupper_l	Adott karakter átalakítása megfelelő nagybetűvé	LC_CTYPE
wcstombs, _wcstombs_l, wcstombs_s_wcstombs_s_l	Széles karakterek sorozatának átalakítása többbájtos karakterek megfelelő sorozatává	LC_CTYPE
wctomb, _wctomb_l, wctomb_s_wctomb_s_l	Széles karakter átalakítása megfelelő többbájtos karakterré	LC_CTYPE

Megjegyzés:

Többbájtos rutinok esetén a többbájtos kódlapnak egyenértékűnek kell lennie a területi beállítással setlocale. _setmbcpargumentummal _MB_CP_LOCALE a többbájtos kódlapot a kódlapéval megegyezőre állítja setlocale .

Lásd még

nemzetköziesítés
Univerzális C futtatókörnyezeti rutinok kategória szerint