CKTIS / C++
std::isalpha — проверка дали даден знак е буква
std::isalpha от <cctype> проверява дали дадена стойност представлява буква според текущия C локал. Функцията връща int: нула или ненулева стойност. Преобразувайте стойността от тип char към unsigned char и подайте резултата само ако е представим като int.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#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 от <cctype> класифицира една стойност на знак според категорията LC_CTYPE на текущия C локал. Функцията връща int: ненулева стойност за буква и 0 в противен случай. Проверявайте != 0, а не == 1 — резултатът за буква не е задължително равен на 1.
Стойността, подадена на параметъра от тип int, трябва да е равна на EOF или да е представима като unsigned char; другите стойности водят до неопределено поведение. При променлива char ch самото преобразуване към int не поправя отрицателна стойност на char. Първо изчислете static_cast<unsigned char>(ch). Извикването std::isalpha(static_cast<unsigned char>(ch)) е безопасно за всяка стойност на ch, ако UCHAR_MAX <= INT_MAX. Ако UCHAR_MAX > INT_MAX, преди преобразуването към int проверете дали получената стойност не надвишава INT_MAX (и двете граници са дефинирани в <climits>). Стойност над INT_MAX не може да бъде подадена без промяна: преобразуването може да даде EOF или друга отрицателна стойност, която води до неопределено поведение. Не извиквайте функцията за такъв байт. Запазете като int резултата от входна функция, която връща int, и проверете дали е EOF, преди да преобразувате байта.
В локала "C" буквите са A–Z и a–z; други локали може да разпознават допълнителни букви. Функцията не декодира UTF-8: класифицирането на отделни байтове не определя дали многобайтов знак на Unicode е буква.
Не бъркайте тази функция с двуаргументната std::isalpha(ch, loc) от <locale>, която връща bool и използва изрично зададен обект за локал. Примерът по-долу предполага, че използваните стойности са представими като int след преобразуването им към unsigned char. Той задава LC_CTYPE на "C" и отпечатва резултата след нормализирането му до bool, така че очакваният изход не зависи от конкретната ненулева стойност, върната от библиотеката.
Примери
#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';
}
}
Резултат
A: 1 z: 1 7: 0 _: 0
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.