Sdílet prostřednictvím

_strupr, _strupr_l, _mbsupr, _mbsupr_l, , _wcsupr_l_wcsupr

  • Článek

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

Důležité

_mbsupra _mbsupr_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

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 pro velká písmena.

locale
Národní prostředí, které se má použít

Vrácená hodnota

Vrátí ukazatel na změněný řetězec. Vzhledem k tomu, že se změna provádí na místě, je vrácený ukazatel stejný jako ukazatel předaný jako vstupní argument. Žádná návratová hodnota není vyhrazena k označení chyby.

Poznámky

Funkce _strupr převede všechna malá písmena na str velká písmena. 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í. Verze s _l příponou jsou shodné s tím rozdílem, že místo toho používají předané národní prostředí. Další informace naleznete v tématu Národní prostředí.

_wcsupra _mbsupr jsou širokoznakové a vícebajtové verze ._strupr Argument a návratová hodnota jsou řetězce širokého znaku _wcsupr . Argument a návratová _mbsupr hodnota jsou řetězce s vícebajtovými znaky. Tyto tři funkce se chovají stejně jinak.

Pokud str je ukazatel null, je vyvolána neplatná obslužná rutina 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 se 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í šablon zabezpečení.

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 _strupr _mbsupr _wcsupr
_tcsupr_l _strupr_l _mbsupr_l _wcsupr_l

Požadavky

Rutina Požadovaný hlavičkový soubor
_strupr, _strupr_l <string.h>
_wcsupr, _wcsupr_l <string.h> nebo <wchar.h>
_mbsupr, _mbsupr_l <mbstring.h>

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

Příklad

Podívejte se na příklad pro _strlwr.

Viz také

Národní prostředí
Manipulace s řetězci
_strlwr, _wcslwr, _mbslwr, _strlwr_l, , _wcslwr_l_mbslwr_l