_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_lmají _wcsuprvylepšení zabezpečení, jak je popsáno v funkcích zabezpečení v CRT._strupr

Důležité

_mbsupr_sa _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 ERANGEhodnotu .

Poznámky

Funkce _strupr_s převede všechna malá písmena na str velká písmena. _wcsupr_sje širokoznační verze ._strupr_s _mbsupr_s je vícebajtů znakové _strupr_sverze .

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_CTYPEté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