_strupr_s
, _strupr_s_l
, _mbsupr_s
, _mbsupr_s_l
, , _wcsupr_s
_wcsupr_s_l
Převede řetězec na velká písmena pomocí aktuálního národního prostředí nebo zadaného národního prostředí, které je předáno. Tyto verze , , _strupr_l
_mbsupr
, _mbsupr_l
, _wcsupr_l
mají _wcsupr
vylepšení zabezpečení, jak je popsáno v funkcích zabezpečení v CRT._strupr
Důležité
_mbsupr_s
a _mbsupr_s_l
nelze je použít v aplikacích, které se spouští v prostředí Windows Runtime. Další informace najdete v tématu Funkce CRT, které nejsou v aplikacích Univerzální platforma Windows podporované.
Syntaxe
errno_t _strupr_s(
char *str,
size_t numberOfElements
);
errno_t _wcsupr_s(
wchar_t * str,
size_t numberOfElements
);
errno_t _strupr_s_l(
char * str,
size_t numberOfElements,
_locale_t locale
);
errno_t _wcsupr_s_l(
wchar_t * str,
size_t numberOfElements,
_locale_t locale
);
errno_t _mbsupr_s(
unsigned char *str,
size_t numberOfElements
);
errno_t _mbsupr_s_l(
unsigned char *str,
size_t numberOfElements,
_locale_t locale
);
template <size_t size>
errno_t _strupr_s(
char (&str)[size]
); // C++ only
template <size_t size>
errno_t _wcsupr_s(
wchar_t (&str)[size]
); // C++ only
template <size_t size>
errno_t _strupr_s_l(
char (&str)[size],
_locale_t locale
); // C++ only
template <size_t size>
errno_t _wcsupr_s_l(
wchar_t (&str)[size],
_locale_t locale
); // C++ only
template <size_t size>
errno_t _mbsupr_s(
unsigned char (&str)[size]
); // C++ only
template <size_t size>
errno_t _mbsupr_s_l(
unsigned char (&str)[size],
_locale_t locale
); // C++ only
Parametry
str
Řetězec pro velká písmena.
numberOfElements
Velikost vyrovnávací paměti.
locale
Národní prostředí, které se má použít
Vrácená hodnota
Nula v případě úspěchu; nenulový kód chyby při selhání.
Tyto funkce ověřují své parametry. Pokud str
je NULL
ukazatel, je vyvolána neplatná obslužná rutina parametru, jak je popsáno v ověření parametru . Pokud je spuštění povoleno pokračovat, funkce se vrátí EINVAL
a nastaví errno
na EINVAL
. Pokud numberOfElements
je menší než délka řetězce, funkce vrátí ERANGE
a nastaví errno
na ERANGE
hodnotu .
Poznámky
Funkce _strupr_s
převede všechna malá písmena na str
velká písmena. _wcsupr_s
je širokoznační verze ._strupr_s
_mbsupr_s
je vícebajtů znakové _strupr_s
verze .
Převod je určen LC_CTYPE
nastavením kategorie národního prostředí. Ostatní znaky nejsou ovlivněny. Další informace naleznete v LC_CTYPE
tématu setlocale
. Verze těchto funkcí bez přípony _l
používají aktuální národní prostředí; vize s _l
příponou jsou shodné s tím rozdílem, že místo toho používají národní prostředí předané. Další informace naleznete v tématu Národní prostředí.
V jazyce C++ je použití těchto funkcí zjednodušeno přetíženími šablon; přetížení mohou automaticky odvodit délku vyrovnávací paměti (eliminuje potřebu zadat argument velikosti) a mohou automaticky nahradit starší, nezabezpečené funkce jejich novějšími zabezpečenými protějšky. Další informace naleznete v tématu Přetížení šablon zabezpečení.
Verze knihovny ladění těchto funkcí nejprve vyplní vyrovnávací paměť 0xFE. Chcete-li toto chování zakázat, použijte _CrtSetDebugFillThreshold
.
Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.
Mapování rutin obecného textu
Rutina TCHAR.H | _UNICODE a _MBCS není definován |
_MBCS definovaný |
_UNICODE definovaný |
---|---|---|---|
_tcsupr_s |
_strupr_s |
_mbsupr_s |
_wcsupr_s |
_tcsupr_s_l |
_strupr_s_l |
_mbsupr_s_l |
_wcsupr_s_l |
Požadavky
Rutina | Požadovaný hlavičkový soubor |
---|---|
_strupr_s , _strupr_s_l |
<string.h> |
_wcsupr_s , _wcsupr_s_l , , _mbsupr_s _mbsupr_s_l |
<string.h> nebo <wchar.h> |
Další informace o kompatibilitě najdete v tématu Kompatibilita.
Příklad
Viz příklad pro , , _strlwr_s_l
_mbslwr_s
, _mbslwr_s_l
, _wcslwr_s
. _wcslwr_s_l
._strlwr_s
Viz také
Národní prostředí
Interpretace vícebajtových sekvencí znaků
Manipulace s řetězci
_strlwr_s
, _strlwr_s_l
, _mbslwr_s
, _mbslwr_s_l
, , _wcslwr_s
_wcslwr_s_l