База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници