_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

Článek
03/26/2013

Převedení řetězce na velká písmena pomocí aktuální národní prostředí nebo předaný zadané národní prostředí.Jedná se o verze _strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr s vylepšení zabezpečení, jak je popsáno v Funkce zabezpečení v CRT.

Důležité
_mbsupr_sa _mbsupr_s_l nelze použít v aplikacích, které jsou spuštěny v systému Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

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 na velká.
numberOfElements
Velikost vyrovnávací paměti.
locale
Národní prostředí pro použití.

Vrácená hodnota

Nula v případě úspěchu; nenulový chybový kód při selhání.

Tyto funkce ověření jejich parametrů.Pokud str je NULL je vyvolán ukazatel, obslužná rutina neplatný parametr, jak je popsáno v Ověření parametrů .Pokud je povoleno zpracování, chcete-li pokračovat, vrátí funkce EINVAL a errno na EINVAL.Pokud numberOfElements je menší než délka řetězce, vrátí funkce ERANGE a errno na ERANGE.

Poznámky

_strupr_s Funkce převede na místě, každý malým písmenem v str na velká písmena._wcsupr_sje verzí širokého znaku _strupr_s._mbsupr_svícebajtové znakové verzi _strupr_s.

Převod je určena LC_CTYPE kategorie nastavení národního prostředí.Jiné znaky nejsou ovlivněny.Další informace o LC_CTYPE, viz setlocale.Verze těchto funkcí, aniž by _l příponu použít aktuální národní prostředí; vize s _l s tím rozdílem, že používají národní prostředí, místo něho předán shodná přípona.Další informace naleznete v tématu Národní prostředí.

V jazyce C++ pomocí těchto funkcí je zjednodušeno díky přetížení šablony; přetížení můžete automaticky odvodit velikost vyrovnávací paměti (není tedy třeba zadat argument velikost) a starší, nezabezpečené funkce lze automaticky nahradí s jejich protějšky novější, bezpečné.Další informace naleznete v tématu Přetížení šablony zabezpečení.

Ladicí verze těchto funkcí vyplnit nejprve vyrovnávací paměť s 0xFD.Chcete-li zakázat toto chování, použijte _CrtSetDebugFillThreshold.

Mapování rutiny obecného textu