toupper

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Bibliothek für Zeichenketten

Null-terminierte Byte-Strings

Null-terminierte Multibyte-Strings

Null-terminierte breite Zeichenketten

 

Null-terminierte Byte-Strings

Funktionen
Zeichenmanipulation
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
Konvertierungen zu und von numerischen Formaten
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtouimax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
Stringmanipulation
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
Stringuntersuchung
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
Speichermanipulation
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
Sonstiges
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

Definiert in Header <ctype.h>
int toupper( int ch );

Wandelt das übergebene Zeichen gemäß den Regeln der Zeichenkonvertierung um, die durch die aktuell installierte C-Locale definiert sind.

In der Standard "C"-Locale werden die folgenden Kleinbuchstaben abcdefghijklmnopqrstuvwxyz durch die entsprechenden Großbuchstaben ABCDEFGHIJKLMNOPQRSTUVWXYZ ersetzt.

Parameter

ch

-

zu konvertierendes Zeichen. Wenn der Wert von ch nicht als unsigned char darstellbar ist und nicht gleich EOF ist, ist das Verhalten undefiniert.

Rückgabewert

Großbuchstaben-Version von ch oder unverändertes ch, wenn in der aktuellen C-Locale keine Großbuchstaben-Version aufgeführt ist.

Beispiel

Führen Sie diesen Code aus

#include <ctype.h>
#include <limits.h>
#include <locale.h>
#include <stdio.h>
 
int main(void)
{
    // in the default locale:
    for (unsigned char l = 0, u; l != UCHAR_MAX; ++l)
        if ((u = toupper(l)) != l)
            printf("%c%c ", l, u);
    printf("\n\n");
 
    unsigned char c = '\xb8'; // the character ž in ISO-8859-15
                              // but ¸ (cedilla) in ISO-8859-1
    setlocale(LC_ALL, "en_US.iso88591");
    printf("in iso8859-1, toupper('0x%x') gives 0x%x\n", c, toupper(c));
    setlocale(LC_ALL, "en_US.iso885915");
    printf("in iso8859-15, toupper('0x%x') gives 0x%x\n", c, toupper(c));
}

Mögliche Ausgabe

aA bB cC dD eE fF gG hH iI jJ kK lL mM nN oO pP qQ rR sS tT uU vV wW xX yY zZ
 
in iso8859-1, toupper('0xb8') gives 0xb8
in iso8859-15, toupper('0xb8') gives 0xb4

Referenzen

• C23-Standard (ISO/IEC 9899:2024)

• 7.4.2.2 Die Funktion toupper (S. TBD)

• C17-Standard (ISO/IEC 9899:2018)

• 7.4.2.2 Die Funktion toupper (S. 147-148)

• C11-Standard (ISO/IEC 9899:2011)

• 7.4.2.2 Die Funktion toupper (S. 204)

• C99-Standard (ISO/IEC 9899:1999)

• 7.4.2.2 Die Funktion toupper (S. 185)

• C89/C90-Standard (ISO/IEC 9899:1990)

• 4.3.2.2 Die Funktion toupper

Siehe auch

tolower	konvertiert ein Zeichen in Kleinbuchstaben (Funktion)
towupper (C95)	wandelt ein breites Zeichen in Großbuchstaben um (Funktion)
C++-Dokumentation für toupper