WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::toupper — ein Zeichen in Großschreibung umwandeln

std::toupper aus <cctype> gibt das Großbuchstaben-Gegenstück eines Zeichens gemäß der aktuellen C-Locale zurück. Das Argument muss EOF entsprechen oder als unsigned char darstellbar sein; der Rückgabewert hat den Typ int.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <cctype>
int std::toupper(int c);

std::toupper aus <cctype> hat die Signatur int std::toupper(int c). Die Funktion gibt gemäß der aktuellen C-Locale den entsprechenden Großbuchstaben zurück oder das unveränderte Argument, wenn keine Umwandlung möglich ist. Sie ändert das Argument nicht: Weise den Rückgabewert zu oder nutze ihn anderweitig.

Der an den Parameter vom Typ int übergebene Wert muss EOF entsprechen oder als unsigned char darstellbar sein. Jeder andere Wert führt zu undefiniertem Verhalten. Da ein gewöhnliches char negativ sein kann, verwende für eine char-Variable std::toupper(static_cast<unsigned char>(ch)), sofern der Wert nach dem Cast als int darstellbar ist. Kann int nicht alle Werte von unsigned char darstellen, prüfe vor dem Aufruf, ob der Wert nach dem Cast als int darstellbar ist. Andernfalls kann die Konvertierung nach int einen negativen Wert ungleich EOF ergeben und damit undefiniertes Verhalten auslösen. Ergibt sie EOF, erhält die Funktion EOF statt des Zeichenwerts. Prüfe einen von einer Eingabefunktion als int zurückgegebenen Wert auf EOF, bevor du ihn in unsigned char umwandelst.

Das Beispiel verarbeitet einen String Zeichen für Zeichen und wandelt das Ergebnis vom Typ int ausdrücklich zurück in char um. Es setzt voraus, dass alle beim Cast nach unsigned char erhaltenen Werte als int darstellbar sind. Bei der anfänglichen Locale "C" ist die erwartete Ausgabe HELLO, C++23!, gefolgt von einem Zeilenumbruch. Das ist kein allgemeines Verfahren zur Umwandlung der Groß- und Kleinschreibung in Unicode: UTF-8-Bytes so zu verarbeiten, reicht nicht aus.

Verwechsle diese Funktion nicht mit der Überladung std::toupper(c, loc) aus <locale>, die ein ausdrücklich übergebenes Locale-Objekt verwendet. Die obigen Hinweise zum Cast nach unsigned char gelten für die Funktion mit einem Argument aus <cctype>.

Beispiele

#include <cctype>
#include <iostream>
#include <string>

int main() {
    std::string text = "Hello, C++23!";
    for (char& ch : text) {
        ch = static_cast<char>(
            std::toupper(static_cast<unsigned char>(ch)));
    }
    std::cout << text << '\n';
}

Ergebnis

HELLO, C++23!

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.

Quellen