Sdílet prostřednictvím

toupper, _toupper, towupper, , _toupper_l_towupper_l

  • Článek

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 rutina _UNICODE a _MBCS není definován _MBCS definovaný _UNICODE definovaný
_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ů