KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::toupper — één teken omzetten naar een hoofdletter

std::toupper uit <cctype> geeft de hoofdlettervariant van een teken terug volgens de huidige C-locale. Het argument moet gelijk zijn aan EOF of weergeefbaar zijn als unsigned char; het retourtype is int.

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

Syntax

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

std::toupper uit <cctype> heeft de signatuur int std::toupper(int c). De functie geeft de bijbehorende hoofdletter terug volgens de huidige C-locale, of het ongewijzigde argument als er geen omzetting mogelijk is. Het argument wordt niet aangepast: wijs het resultaat toe of gebruik het op een andere manier.

De waarde die je aan de parameter van het type int doorgeeft, moet gelijk zijn aan EOF of als unsigned char kunnen worden weergegeven. Elke andere waarde leidt tot ongedefinieerd gedrag. Omdat een gewone char negatief kan zijn, gebruik je voor een char-variabele std::toupper(static_cast<unsigned char>(ch)), mits de waarde na de cast in int past. Als int niet alle waarden van unsigned char kan weergeven, controleer dan vóór de aanroep of de waarde na de cast in int past. Anders kan de omzetting naar int een negatieve waarde opleveren die niet gelijk is aan EOF, met ongedefinieerd gedrag tot gevolg. Levert de omzetting EOF op, dan ontvangt de functie EOF in plaats van de tekenwaarde. Geeft een invoerfunctie een int terug, controleer dan of die waarde EOF is voordat je haar naar unsigned char omzet.

Het voorbeeld verwerkt een tekenreeks teken voor teken en zet het resultaat van het type int expliciet terug om naar char. Het gaat ervan uit dat elke waarde die de cast naar unsigned char oplevert in int past. Bij de aanvankelijke "C"-locale is de verwachte uitvoer HELLO, C++23!, gevolgd door een regeleinde. Dit is geen algemene methode om voor Unicode tussen hoofdletters en kleine letters om te zetten: UTF-8-bytes op deze manier verwerken is niet voldoende.

Verwar deze functie niet met de overload std::toupper(c, loc) uit <locale>, die een expliciet meegegeven locale-object gebruikt. De aanwijzingen hierboven over de cast naar unsigned char gelden voor de functie met één argument uit <cctype>.

Voorbeelden

#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';
}

Resultaat

HELLO, C++23!

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen