Národní prostředí

Národní prostředí označuje nastavení země/oblasti a jazyka, které můžete použít k přizpůsobení programu. Některé kategorie závislé na národním prostředí zahrnují formáty zobrazení kalendářních dat a peněžních hodnot. Další informace naleznete v tématu Kategorie národního prostředí.

setlocale Pomocí funkce můžete při použití funkcí bez _l přípony změnit nebo zadat dotaz na některé nebo všechny aktuální informace o národním prostředí programu nebo vlákna. Funkce s příponou _l budou používat parametr národního prostředí předaný pro informace o národním prostředí pouze během provádění této konkrétní funkce. Chcete-li vytvořit národní prostředí pro použití s funkcí s příponou _l , použijte _create_locale. Chcete-li uvolnit toto národní prostředí, použijte _free_locale. Chcete-li získat aktuální národní prostředí, použijte _get_current_locale.

Slouží _configthreadlocale k řízení, zda má každé vlákno vlastní národní prostředí, nebo všechna vlákna v programu sdílejí stejné národní prostředí. Další informace najdete v tématu Národní prostředí a znakové stránky.

K dispozici jsou bezpečnější verze funkcí v následující tabulce označené příponou _s ("secure"). Další informace naleznete v tématu Funkce zabezpečení v CRT.

Rutiny závislé na národním prostředí

Rutina	Používání	setlocale závislost nastavení kategorie
atof, _atof_l, , _wtof_wtof_l	Převod znaku na hodnotu s plovoucí desetinou čárkou	LC_NUMERIC
atoi, _atoi_l, , _wtoi_wtoi_l	Převod znaku na celočíselnou hodnotu	LC_NUMERIC
_atoi64, _atoi64_l, , _wtoi64_wtoi64_l	Převod znaku na 64bitovou celočíselnou hodnotu	LC_NUMERIC
atol, _atol_l, , _wtol_wtol_l	Převod znaku na dlouhou hodnotu	LC_NUMERIC
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, , _atoflt_atoflt_l	Převod znaku na hodnotu s dvojitou délkou	LC_NUMERIC
is, isw rutiny	Otestujte zadané celé číslo pro konkrétní podmínku.	LC_CTYPE
isleadbyte, _isleadbyte_l	Test potenciálního bajtu	LC_CTYPE
localeconv	Čtení vhodných hodnot pro formátování číselných množství	LC_MONETARY, LC_NUMERIC
MB_CUR_MAX	Maximální délka v bajtech libovolného vícebajtového znaku v aktuálním národním prostředí (makro definované v STDLIB.H)	LC_CTYPE
_mbccpy, _mbccpy_l, ,_mbccpy_s_mbccpy_s_l	Kopírování jednoho vícebajtového znaku	LC_CTYPE
_mbclen, , mblen_mblen_l	Ověření a vrácení počtu bajtů ve vícebajtových znacích	LC_CTYPE
strlen, wcslen, _mbslen, _mbslen_l, , _mbstrlen_mbstrlen_l	Pro řetězce s vícebajtovými znaky: ověřte každý znak v řetězci; návratová délka řetězce	LC_CTYPE
mbstowcs, _mbstowcs_l, ,mbstowcs_s_mbstowcs_s_l	Převod posloupnosti vícebajtových znaků na odpovídající sekvenci širokých znaků	LC_CTYPE
mbtowc, _mbtowc_l	Převod vícebajtového znaku na odpovídající široký znak	LC_CTYPE
printf – funkce	Zápis formátovaného výstupu	LC_NUMERIC (určuje výstup znaku radix)
scanf – funkce	Čtení formátovaného vstupu	LC_NUMERIC (určuje rozpoznávání znaků radix)
setlocale, _wsetlocale	Výběr národního prostředí pro program	Nelze použít
strcoll, wcscoll, _mbscoll, _strcoll_l, , _wcscoll_l_mbscoll_l	Porovnání znaků dvou řetězců	LC_COLLATE
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, , _wcsicmp_l_mbsicmp_l	Porovnání dvou řetězců bez ohledu na malá a velká písmena	LC_CTYPE
_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, , _wcsicoll_l_mbsicoll_l	Porovnání znaků dvou řetězců (nerozlišující malá a velká písmena)	LC_COLLATE
_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, , _wcsncoll_l_mbsncoll_l	Porovnání prvních n znaků dvou řetězců	LC_COLLATE
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, , _wcsnicmp_l_mbsnicmp_l	Porovnejte znaky dvou řetězců bez ohledu na malá a velká písmena.	LC_CTYPE
_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, , _wcsnicoll_l_mbsnicoll_l	Porovnání prvních n znaků dvou řetězců (nerozlišující malá a velká písmena)	LC_COLLATE
strftime, wcsftime, , _strftime_l_wcsftime_l	Formátování hodnoty data a času podle zadaného format argumentu	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	Převeďte všechna velká písmena v daném řetězci na malá písmena.	LC_CTYPE
strtod, _strtod_l, , wcstod_wcstod_l	Převod řetězce znaků na double hodnotu	LC_NUMERIC (určuje rozpoznávání znaků radix)
strtol, wcstol, , _strtol_l_wcstol_l	Převod řetězce znaků na long hodnotu	LC_NUMERIC (určuje rozpoznávání znaků radix)
strtoul, _strtoul_l, , wcstoul_wcstoul_l	Převod řetězce znaků na dlouhou hodnotu bez znaménka	LC_NUMERIC (určuje rozpoznávání znaků radix)
_strupr, _strupr_l, , _mbsupr, _mbsupr_l_wcsupr_l_wcsupr_strupr_s_strupr_s_l_mbsupr_s_mbsupr_s_l_wcsupr_s_wcsupr_s_l	Převeďte všechna malá písmena v řetězci na velká písmena.	LC_CTYPE
strxfrm, wcsxfrm, , _strxfrm_l_wcsxfrm_l	Transformace řetězce na kompletovaný formulář podle národního prostředí	LC_COLLATE
tolower, _tolower, , towlower_tolower_l_towlower_l_mbctolower_mbctolower_l, , _mbctoupper_mbctoupper_l	Převedení daného znaku na odpovídající znak malými písmeny	LC_CTYPE
toupper, _toupper, , towupper_toupper_l_towupper_l_mbctolower_mbctolower_l, , _mbctoupper_mbctoupper_l	Převedení daného znaku na odpovídající velká písmena	LC_CTYPE
wcstombs, _wcstombs_l, ,wcstombs_s_wcstombs_s_l	Převod posloupnosti širokých znaků na odpovídající sekvenci vícebajtových znaků	LC_CTYPE
wctomb, _wctomb_l, ,wctomb_s_wctomb_s_l	Převedení širokého znaku na odpovídající vícebajtový znak	LC_CTYPE

Poznámka:

Pro vícebajtové rutiny musí být vícebajtová znaková stránka ekvivalentní národnímu prostředí s setlocale. _setmbcp, s argumentem _MB_CP_LOCALE vytvoří vícebajtovou znakovou stránku stejnou jako setlocale znaková stránka.

Viz také

Internacionalizace
Rutiny UCRT (Universal C runtime) podle kategorie