_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

Článek
03/26/2013

Převedení řetězce na velká písmena.Bezpečnější verze tyto funkce jsou k dispozici; see _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.

Důležité
_mbsupra _mbsupr_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.

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 na velká.
locale
Národní prostředí pro použití.

Vrácená hodnota

Vrací ukazatel na řetězec změněné.Protože změna se provádí na místě, ukazatel vrácena, je stejný jako ukazatel předaný jako vstupní argument.Žádné vrácená hodnota je vyhrazena udávající chybu.

Poznámky

_strupr Funkce převede na místě, každý malým písmenem v str na velká písmena.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í; verze 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í.

_wcsupra _mbsupr jsou verze širokého znaku a vícebajtové znakové sady _strupr.Argument a vrací hodnotu _wcsupr jsou řetězci širokého znaku; u _mbsupr jsou vícebajtové znakové řetězce.Tyto tři funkce chovat identicky jinak.

Pokud str je ukazatel s hodnotou null, je vyvolána obslužná rutina neplatný parametr, jak je popsáno v Ověření parametrů .Je-li pokračovat, tyto funkce vrácení původní řetězec a nastavte je povoleno zpracování errno na EINVAL.

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

Mapování rutiny obecného textu

TCHAR.Byla zahájena rutina h	_UNICODE & _MBCS není definováno	_MBCS, definice	_UNICODE definována
_tcsupr	_strupr	_mbsupr	_wcsupr
_tcsupr_l	_strupr_l	_mbsupr_l	_wcsupr_l

Požadavky

Byla zahájena 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ě, viz Compatibility v úvodu.

Příklad

Viz příklad pro _strlwr.

Ekvivalent v rozhraní .NET Framework

System::String::ToUpper

Viz také

Referenční dokumentace

Národní prostředí

Manipulaci s řetězci (CRT)

_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Sdílet prostřednictvím