toupper, _toupper, towupper, , _toupper_l_towupper_l

Převede znak na velká písmena.

Syntaxe

int toupper(
   int c
);
int _toupper(
   int c
);
int towupper(
   wint_t c
);
int _toupper_l(
   int c ,
   _locale_t locale
);
int _towupper_l(
   wint_t c ,
   _locale_t locale
);

Parametry

c
Znak, který se má převést.

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

Vrácená hodnota

Každá z těchto rutin převede kopii c, pokud je to možné, a vrátí výsledek.

Pokud c je široký znak, pro který iswlower je nenulový a existuje odpovídající široký znak, pro který iswupper je nenulový, towupper vrátí odpovídající široký znak. V opačném případě towupper se vrátí c beze změny.

Pro označení chyby není vyhrazena žádná návratová hodnota.

Poznámky

Každá z těchto rutin převede dané malé písmeno na velké písmeno, pokud je to možné a vhodné. Převod případu towupper je specifický pro národní prostředí. V případě se změní pouze znaky relevantní pro aktuální národní prostředí. Funkce bez přípony _l používají aktuálně nastavené národní prostředí. Verze těchto funkcí s _l příponou přebírají národní prostředí jako parametr a používají se místo aktuálně nastaveného národního prostředí. Další informace naleznete v tématu Národní prostředí.

Aby toupper se daly očekávané výsledky, __isascii musí být vráceny nenulové hodnoty.

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

TCHAR.H Rutinní	_UNICODE a _MBCS není definován	_MBCS Definovány	_UNICODE Definovány
_totupper	toupper	_mbctoupper	towupper
_totupper_l	_toupper_l	_mbctoupper_l	_towupper_l

Poznámka:

_toupper_l a _towupper_l nemají žádnou závislost na národním prostředí a nemají být volána přímo. Jsou poskytovány pro interní použití ._totupper_l

Požadavky

Rutina	Požadovaný hlavičkový soubor
toupper	<ctype.h>
_toupper	<ctype.h>
towupper	<ctype.h> nebo <wchar.h>

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

Příklad

Podívejte se na příklad ve to funkcích.

Viz také

is, isw rutiny
to – funkce
Národní prostředí
Interpretace vícebajtových sekvencí znaků