toupper, _toupper, towupper, _toupper_l, _towupper_l

Artikel
06/09/2015

Konvertieren Sie Zeichen in Großbuchstaben.

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 möglich, und gibt das Ergebnis aus.

Wenn c für das ein Breitzeichen iswlower ist nicht 0 ist und es ist ein entsprechendes Breitzeichen, für das ein iswupper ungleich 0 ist, towupper den entsprechenden Breitzeichen zurückgibt; andernfalls towupper zurückgibt c unverändert.

Es gibt keinen Rückgabewert, der reserviert wird, um einen Fehler anzugeben.

Damit toupper erwarteten Ergebnisse gibt, __isascii und islower muss jeweils Rückholwert ungleich 0.

Hinweise

Jede dieser Routinen konvertiert einen angegebenen Kleinbuchstaben zu einem Großbuchstaben, wenn möglich und entsprechend. Die Unterscheidung der Groß-/Kleinschreibung von towupper ist gebietsschemaspezifisch. Nur die Zeichen, die dem aktuellen Gebietsschema relevant sind, werden ggf. geändert. Die Features ohne das Suffix _l verwenden das gerade angegebene Gebietsschema. Die Versionen dieser Funktionen mit dem Suffix _l nehmen das Gebietsschema als Parameter verwenden und die aktuell festgelegten anstelle des Gebietsschemas. Weitere Informationen finden Sie unter Locale.

Damit toupper erwarteten Ergebnisse gibt, __isascii und isupper muss jeweils Rückholwert ungleich 0.

Datenkonvertierungs-Routinen

Zuordnung generischer Textroutinen

TCHAR.H-Routine	_UNICODE & _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.