KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::isalpha — controleren of een teken een letter is

std::isalpha uit <cctype> controleert of een waarde volgens de huidige C-locale een letter voorstelt. De functie retourneert int: nul of een waarde die niet nul is. Zet een char-waarde om naar unsigned char en geef het resultaat alleen door als het in int past.

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

Syntax

#include <cctype>
#include <climits>
// Signature: int std::isalpha(int c);

const auto byte = static_cast<unsigned char>(ch);
if (byte <= INT_MAX) {
    const bool letter = std::isalpha(static_cast<int>(byte)) != 0;
    // Use letter here.
} else {
    // This byte cannot be passed to std::isalpha as its original value.
}

std::isalpha uit <cctype> classificeert één tekenwaarde volgens de categorie LC_CTYPE van de huidige C-locale. De functie retourneert int: een waarde die niet nul is voor een letter en 0 anders. Test op != 0, niet op == 1 — een waar resultaat hoeft niet gelijk te zijn aan 1.

De waarde die je aan de int-parameter doorgeeft, moet gelijk zijn aan EOF of in unsigned char passen; andere waarden veroorzaken ongedefinieerd gedrag. Bij een variabele char ch lost alleen omzetten naar int het probleem van een negatieve char-waarde niet op. Bereken eerst static_cast<unsigned char>(ch). De aanroep std::isalpha(static_cast<unsigned char>(ch)) is veilig voor elke ch als UCHAR_MAX <= INT_MAX. Als UCHAR_MAX > INT_MAX, controleer dan vóór omzetting naar int of de verkregen waarde hoogstens INT_MAX is (beide grenswaarden zijn gedefinieerd in <climits>). Een waarde boven INT_MAX kun je niet ongewijzigd doorgeven: de omzetting kan EOF opleveren of een andere negatieve waarde die ongedefinieerd gedrag veroorzaakt. Roep de functie voor zo’n byte niet aan. Houd het resultaat van een invoerfunctie die int retourneert als int en controleer op EOF voordat je de byte omzet.

In de locale "C" zijn A–Z en a–z letters; andere locales kunnen extra letters herkennen. De functie decodeert geen UTF-8: afzonderlijke bytes classificeren bepaalt niet of een multibyte Unicode-teken een letter is.

Verwar deze functie niet met std::isalpha(ch, loc) uit <locale>, dat twee argumenten accepteert, bool retourneert en een expliciet locale-object gebruikt. Het voorbeeld hieronder gaat ervan uit dat de gebruikte waarden na omzetting naar unsigned char in int passen. Het stelt LC_CTYPE in op "C" en drukt het resultaat af nadat het naar bool is genormaliseerd. Daardoor hangt de verwachte uitvoer niet af van de specifieke waarde ongelijk aan nul die de bibliotheek retourneert.

Voorbeelden

#include <cctype>
#include <clocale>
#include <initializer_list>
#include <iostream>

int main() {
    if (std::setlocale(LC_CTYPE, "C") == nullptr) {
        return 1;
    }

    for (char ch : {'A', 'z', '7', '_'}) {
        const bool letter =
            std::isalpha(static_cast<unsigned char>(ch)) != 0;
        std::cout << ch << ": " << letter << '\n';
    }
}

Resultaat

A: 1
z: 1
7: 0
_: 0

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