CKTIS / C
toupper — einen Kleinbuchstaben in einen Großbuchstaben umwandeln
toupper aus <ctype.h> gibt gemäß der aktuellen Locale den entsprechenden Großbuchstaben zurück oder lässt den Wert unverändert.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <ctype.h>
int toupper(int c);toupper nimmt einen int entgegen und gibt einen int zurück. Bei einem Kleinbuchstaben liefert die Funktion den entsprechenden Großbuchstaben gemäß der aktuellen Locale; gibt es mehrere passende Großbuchstaben, ist die Auswahl für diese Locale festgelegt. Andernfalls gibt sie das Argument unverändert zurück.
Das Argument muss als unsigned char darstellbar oder gleich EOF sein; andernfalls ist das Verhalten undefiniert. Für eine Variable char c verwende toupper((unsigned char)c). Bewahre ein Ergebnis von getchar() als int auf und erhalte EOF ohne Umwandlung.
Die Funktion verändert weder ihr Argument noch eine ganze Zeichenkette. Sie eignet sich nicht dazu, UTF-8-Text Byte für Byte umzuwandeln.
Beispiele
#include <ctype.h>
#include <stdio.h>
int main(void)
{
char c = 'a';
printf("%c %c\n", toupper((unsigned char)c), toupper('7'));
return 0;
}
Ergebnis
A 7
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.