toupper, _toupper, towupper, _toupper_l, _towupper_l

Zeichen in Großbuchstaben konvertieren.

Syntax

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
);

Parameter

c
Zu konvertierendes Zeichen.

locale
Zu verwendendes Gebietsschema.

Rückgabewert

Jede dieser Routinen konvertiert eine Kopie von c, wenn die Konvertierung möglich ist, und gibt das Ergebnis zurück.

Wenn c ein Breitzeichen ist, für das iswlower ungleich null ist und es ein entsprechendes Breitzeichen gibt, für das iswupper ungleich null ist, gibt towupper das entsprechende Breitzeichen zurück;andernfalls gibt towupperc unverändert zurück.

Es ist kein Rückgabewert zur Fehleranzeige reserviert.

Hinweise

Jede dieser Routinen konvertiert einen vorhandenen Kleinbuchstaben in einen Großbuchstaben, wenn dies möglich und relevant ist. Die Konvertierung von towupper ist gebietsschemaspezifisch. Es werden nur die für das aktuelle Gebietsschema relevanten Zeichen geändert. Die Funktion ohne das Suffix _l verwenden das aktuelle Gebietsschema. Die Versionen dieser Funktionen mit dem Suffix _l übernehmen das Gebietsschema als Parameter und verwenden diesen anstatt des aktuellen Gebietsschemas. Weitere Informationen finden Sie unter Locale.

Damit toupper die erwarteten Ergebnisse zurückgibt, muss __isascii „nonzero“ zurückgeben.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

TCHAR.H-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_totupper	toupper	_mbctoupper	towupper
_totupper_l	_toupper_l	_mbctoupper_l	_towupper_l

Hinweis

_toupper_l und _towupper_l haben keine Gebietsschemaabhängigkeit und sind nicht für den direkten Aufruf vorgesehen. Sie werden zur internen Verwendung von _totupper_l bereitgestellt.

Anforderungen

Routine	Erforderlicher Header
toupper	<ctype.h>
_toupper	<ctype.h>
towupper	<ctype.h> oder <wchar.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

Siehe das Beispiel in to-Funktionen.

Siehe auch

is, isw-Routinen
to-Funktionen
Gebietsschema
Interpretation von Multibytezeichensequenzen