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.