WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::isalpha — prüfen, ob ein Zeichen ein Buchstabe ist

std::isalpha aus <cctype> prüft anhand der aktuellen C-Locale, ob ein Wert einen Buchstaben darstellt. Die Funktion gibt int zurück: null oder einen Wert ungleich null. Wandeln Sie einen char-Wert in unsigned char um und übergeben Sie das Ergebnis nur, wenn es als int darstellbar ist.

Version: 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 aus <cctype> klassifiziert einen einzelnen Zeichenwert anhand der Kategorie LC_CTYPE der aktuellen C-Locale. Die Funktion gibt int zurück: einen Wert ungleich null für einen Buchstaben und 0 andernfalls. Prüfen Sie auf != 0, nicht auf == 1 — ein wahrer Wert muss nicht gleich 1 sein.

Der an den int-Parameter übergebene Wert muss gleich EOF oder als unsigned char darstellbar sein; andere Werte führen zu undefiniertem Verhalten. Bei einer Variablen char ch behebt eine bloße Umwandlung in int keinen negativen char-Wert. Werten Sie zuerst static_cast<unsigned char>(ch) aus. Der Aufruf std::isalpha(static_cast<unsigned char>(ch)) ist für jedes ch sicher, wenn UCHAR_MAX <= INT_MAX gilt. Gilt UCHAR_MAX > INT_MAX, prüfen Sie vor der Umwandlung in int, ob der erhaltene Wert höchstens INT_MAX beträgt (beide Grenzwerte sind in <climits> definiert). Ein Wert über INT_MAX kann nicht unverändert übergeben werden: Die Umwandlung kann EOF oder einen anderen negativen Wert ergeben, der zu undefiniertem Verhalten führt. Rufen Sie die Funktion für ein solches Byte nicht auf. Behalten Sie das Ergebnis einer Eingabefunktion, die int zurückgibt, als int bei und prüfen Sie auf EOF, bevor Sie das Byte umwandeln.

In der Locale "C" sind A–Z und a–z Buchstaben; andere Locales können zusätzliche Buchstaben erkennen. Die Funktion dekodiert kein UTF-8: Die Klassifizierung einzelner Bytes stellt nicht fest, ob ein mehrbyteiges Unicode-Zeichen ein Buchstabe ist.

Verwechseln Sie diese Funktion nicht mit std::isalpha(ch, loc) aus <locale>, das zwei Argumente annimmt, bool zurückgibt und ein explizites Locale-Objekt verwendet. Das folgende Beispiel setzt voraus, dass seine Werte nach der Umwandlung in unsigned char als int darstellbar sind. Es setzt LC_CTYPE auf "C" und gibt das Ergebnis nach der Umwandlung in bool aus. Dadurch hängt die erwartete Ausgabe nicht vom konkreten Wert ungleich null ab, den die Bibliothek zurückgibt.

Beispiele

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

Ergebnis

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

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