Namespaces
Variants

toupper

From cppreference.net
< c ‎ | string ‎ | byte
C
Strings library
Null-terminated byte strings
Functions
Character manipulation
Conversions to and from numeric formats
String manipulation
String examination
Memory manipulation
Miscellaneous
(C11) (C11)
Definiert in Header <ctype.h>
int toupper ( int ch ) ;

Wandelt das gegebene Zeichen gemäß den Zeichenkonvertierungsregeln der aktuell installierten C-Locale in Großbuchstaben um.

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

Inhaltsverzeichnis

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 falls keine Großbuchstaben-Version in der aktuellen C-Locale vorhanden ist.

Beispiel

Diesen Code ausführen 
#include <ctype.h>
#include <limits.h>
#include <locale.h>
#include <stdio.h>
int main(void)
{
    // in der Standard-Lokalisierung:
    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'; // das Zeichen ž in ISO-8859-15
                              // aber ¸ (Cedille) 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 toupper-Funktion (S.: TBD)
  • C17-Standard (ISO/IEC 9899:2018):
  • 7.4.2.2 Die toupper-Funktion (S: 147-148)
  • C11-Standard (ISO/IEC 9899:2011):
  • 7.4.2.2 Die toupper-Funktion (S: 204)
  • C99-Standard (ISO/IEC 9899:1999):
  • 7.4.2.2 Die toupper-Funktion (S: 185)
  • C89/C90 Standard (ISO/IEC 9899:1990):
  • 4.3.2.2 Die toupper-Funktion

Siehe auch

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