Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::isalpha — overenie, či je znak písmeno

std::isalpha z <cctype> overuje, či hodnota predstavuje písmeno podľa aktuálneho národného prostredia C. Vracia int: nulu alebo nenulovú hodnotu. Hodnotu typu char preveďte na unsigned char a výsledok odovzdajte iba vtedy, ak je reprezentovateľný ako int.

Verzia: 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 z <cctype> klasifikuje jednu znakovú hodnotu podľa kategórie LC_CTYPE aktuálneho národného prostredia C. Vracia int: nenulovú hodnotu pre písmeno a 0 v opačnom prípade. Testujte != 0, nie == 1 — pravdivý výsledok nemusí byť rovný 1.

Hodnota odovzdaná parametru typu int musí byť rovná EOF alebo byť reprezentovateľná ako unsigned char; iné hodnoty spôsobujú nedefinované správanie. Pri premennej char ch samotný prevod na int neopraví zápornú hodnotu typu char. Najprv vyhodnoťte static_cast<unsigned char>(ch). Volanie std::isalpha(static_cast<unsigned char>(ch)) je bezpečné pre ľubovoľné ch, ak platí UCHAR_MAX <= INT_MAX. Ak platí UCHAR_MAX > INT_MAX, pred prevodom na int overte, či získaná hodnota nepresahuje INT_MAX (obe hranice sú definované v <climits>). Hodnotu väčšiu ako INT_MAX nemožno odovzdať bez zmeny: prevod môže dať EOF alebo inú zápornú hodnotu, ktorá spôsobí nedefinované správanie. Pre takýto bajt funkciu nevolajte. Výsledok vstupnej funkcie vracajúcej int ponechajte typu int a pred prevodom bajtu overte, či nejde o EOF.

V národnom prostredí "C" sú písmená A–Z a a–z; iné prostredia môžu rozpoznávať ďalšie písmená. Funkcia nedekóduje UTF-8: klasifikácia jednotlivých bajtov neurčuje, či je viacbajtový znak Unicode písmenom.

Nezamieňajte túto funkciu s dvojargumentovým std::isalpha(ch, loc) z <locale>, ktoré vracia bool a používa explicitne odovzdaný objekt národného prostredia. Nasledujúci príklad predpokladá, že použité hodnoty sú po prevode na unsigned char reprezentovateľné ako int. Nastaví LC_CTYPE na "C" a vypíše výsledok prevedený na bool, takže očakávaný výstup nezávisí od konkrétnej nenulovej hodnoty vrátenej knižnicou.

Príklady

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

Výsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje