CKTIS / C++
std::isalpha — sprawdzanie, czy znak jest literą
std::isalpha z <cctype> sprawdza, czy wartość reprezentuje literę według bieżących ustawień regionalnych C. Zwraca int: zero albo wartość niezerową. Aby sklasyfikować wartość typu char, przekształć ją do unsigned char i przekaż wynik tylko wtedy, gdy mieści się w zakresie int.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#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 z nagłówka <cctype> klasyfikuje pojedynczą wartość znaku według bieżących ustawień regionalnych C, w kategorii LC_CTYPE. Zwraca int: wartość niezerową dla litery i 0 w przeciwnym razie. Sprawdzaj != 0, a nie == 1 — wynik prawdziwy nie musi być równy 1.
Wartość przekazana do parametru typu int musi być równa EOF albo być reprezentowalna jako unsigned char; inne wartości powodują niezdefiniowane zachowanie. Dla zmiennej char ch samo przekształcenie do int nie naprawia ujemnej wartości char. Najpierw oblicz static_cast<unsigned char>(ch). Wywołanie std::isalpha(static_cast<unsigned char>(ch)) jest bezpieczne dla dowolnego ch, jeśli UCHAR_MAX <= INT_MAX. Jeśli UCHAR_MAX > INT_MAX, przed konwersją do int sprawdź, czy uzyskana wartość nie przekracza INT_MAX (oba limity pochodzą z <climits>). Wartości większej niż INT_MAX nie da się przekazać bez jej zmiany: konwersja może dać EOF albo inną wartość ujemną, która powoduje niezdefiniowane zachowanie. Nie wywołuj funkcji dla takiego bajtu. Wynik funkcji wejściowej zwracającej int zachowaj jako int i sprawdź EOF przed przekształceniem bajtu.
W ustawieniach "C" literami są A–Z i a–z; inne ustawienia mogą rozpoznawać dodatkowe litery. Funkcja nie dekoduje UTF-8: klasyfikowanie osobnych bajtów nie sprawdza, czy wielobajtowy znak Unicode jest literą.
Nie myl tej funkcji z dwuargumentowym std::isalpha(ch, loc) z <locale>, które zwraca bool i korzysta z jawnego obiektu ustawień regionalnych. Przykład poniżej zakłada, że użyte wartości po konwersji do unsigned char mieszczą się w zakresie int. Ustawia LC_CTYPE na "C" i wypisuje wynik po normalizacji do bool, dzięki czemu oczekiwane wyjście nie zależy od konkretnej niezerowej wartości zwracanej przez bibliotekę.
Przykłady
#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';
}
}
Wynik
A: 1 z: 1 7: 0 _: 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.