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 towupper c 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

Anforderungen

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