toupper, _toupper, towupper, _toupper_l, _towupper_l

  • Artikel
  • 2 Minuten Lesedauer

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 es sich um ein breites Zeichen handelt, iswlower für das nichtzero ist und ein entsprechendes iswupper breites Zeichen vorhanden ist, towupper gibt das entsprechende breite Zeichen zurück. Andernfalls towupper wird unverändert zurückgegeben c .

Es ist kein Rückgabewert reserviert, um einen Fehler anzugeben.

Um toupper den erwarteten Ergebnissen zu geben, __isascii und islower muss beide Nichtzero zurückgeben.

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 Funktionen 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.

Um toupper den erwarteten Ergebnissen zu geben, __isascii und isupper muss beide Nichtzero zurückgeben.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie unter "Globaler Zustand" im CRT.

Generische Textroutinezuordnungen

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 zurückgegebener Wert Erforderlicher Header
toupper <ctype.h>
_toupper <ctype.h>
towupper <ctype.h> oder <wchar.h>

Weitere Informationen zur Kompatibilität finden Sie unter Compatibility.

Beispiel

Sehen Sie sich das Beispiel in Funktionen anto.

Weitere Informationen

is, isw Routinen
to Funktionen
Gebietsschema
Interpretation von Multibytezeichensequenzen