_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

Článek
06/09/2015

Převede řetězec na velká písmena.Bezpečnější verze těchto funkcí jsou k dispozici; viz _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.

Důležité
_mbsupr a _mbsupr_l nelze použít v aplikacích, které jsou spouštěny v modulu Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

char *_strupr(
   char *str 
);
wchar_t *_wcsupr(
   wchar_t *str 
);
unsigned char *_mbsupr(
   unsigned char *str 
);
char *_strupr_l(
   char *str,
   _locale_t locale
);
wchar_t *_wcsupr_l(
   wchar_t *str,
   _locale_t locale
);
unsigned char *_mbsupr_l(
   unsigned char *str,
   _locale_t locale
);
template <size_t size>
char *_strupr(
   char (&str)[size]
); // C++ only
template <size_t size>
wchar_t *_wcsupr(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
unsigned char *_mbsupr(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
char *_strupr_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
wchar_t *_wcsupr_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
unsigned char *_mbsupr_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only

Parametry

str
Řetězec, který se má převést na velká písmena.
locale
Použité národní prostředí.

Vrácená hodnota

Vrací ukazatel na upravený řetězec.Vzhledem k tomu, že změna se provádí na místě, vrácený ukazatel je stejný jako ukazatel předaný jako vstupní argument.Není rezervována žádná vrácená hodnota pro indikaci chyby.

Poznámky

Funkce _strupr převede na místě každé malé písmeno v str na velké písmeno.Převod je určen nastavením kategorie LC_CTYPE národního prostředí.Jiné znaky nejsou ovlivněny.Další informace o LC_CTYPE naleznete v části setlocale.Verze těchto funkcí bez přípony _l používají aktuální národní prostředí pro toto chování závislé na národním prostředí. Verze s příponou _l jsou stejné s tím rozdílem, že používají předaný parametr národního prostředí.Další informace naleznete v tématu Národní prostředí.

_wcsupr a _mbsupr jsou širokoznaká verze a vícebajtová znaková verze _strupr.Argument a vrácená hodnota _wcsupr jsou širokoznaké řetězce. Hodnoty _mbsupr jsou vícebajtové znakové řetězce.Tyto tři funkce se chovají identicky jinak.

Pokud str je ukazatel s hodnotou null, je vyvolána obslužná rutina neplatného parametru, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, vrátí tyto funkce původní řetězec a nastaví errno na EINVAL.

V jazyce C++ mají tyto funkce přetížení šablon, která vyvolávají novější, zabezpečené protějšky těchto funkcí.Další informace naleznete v tématu Přetížení zabezpečení šablony.

Rutinní mapování obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definováno	_MBCS definováno	_UNICODE definováno
_tcsupr	_strupr	_mbsupr	_wcsupr
_tcsupr_l	_strupr_l	_mbsupr_l	_wcsupr_l

Požadavky

Rutina	Požadované záhlaví
_strupr, _strupr_l	<string.h>
_wcsupr, _wcsupr_l	<string.h> nebo <wchar.h>
_mbsupr, _mbsupr_l	<mbstring.h>

Další informace o kompatibilitě naleznete v tématu Kompatibilita.

Příklad

Viz příklad _strlwr.

Ekvivalent v rozhraní .NET Framework

System::String::ToUpper

Viz také

Referenční dokumentace

Národní prostředí

Zacházení s řetězci (CRT)

_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Sdílet prostřednictvím