CKTIS / C++
std::isalpha — ověření, zda je znak písmeno
std::isalpha z <cctype> ověřuje, zda hodnota představuje písmeno podle aktuálního národního prostředí C. Vrací int: nulu nebo nenulovou hodnotu. Hodnotu typu char převeďte na unsigned char a výsledek předejte jen tehdy, pokud je reprezentovatelný jako int.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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 znakovou hodnotu podle kategorie LC_CTYPE aktuálního národního prostředí C. Vrací int: nenulovou hodnotu pro písmeno a 0 v opačném případě. Testujte != 0, nikoli == 1 — pravdivý výsledek nemusí být roven 1.
Hodnota předaná parametru typu int musí být rovna EOF nebo být reprezentovatelná jako unsigned char; jiné hodnoty způsobují nedefinované chování. U proměnné char ch pouhý převod na int zápornou hodnotu typu char neopraví. Nejprve vyhodnoťte static_cast<unsigned char>(ch). Volání std::isalpha(static_cast<unsigned char>(ch)) je bezpečné pro libovolné ch, pokud platí UCHAR_MAX <= INT_MAX. Pokud platí UCHAR_MAX > INT_MAX, před převodem na int ověřte, že získaná hodnota nepřesahuje INT_MAX (obě meze jsou definovány v <climits>). Hodnotu větší než INT_MAX nelze předat beze změny: převod může dát EOF nebo jinou zápornou hodnotu, která způsobí nedefinované chování. Pro takový bajt funkci nevolejte. Výsledek vstupní funkce vracející int ponechte typu int a před převodem bajtu ověřte, zda nejde o EOF.
V národním prostředí "C" jsou písmena A–Z a a–z; jiná prostředí mohou rozpoznávat další písmena. Funkce nedekóduje UTF-8: klasifikace jednotlivých bajtů neurčuje, zda je vícebajtový znak Unicode písmenem.
Nezaměňujte tuto funkci za dvouargumentové std::isalpha(ch, loc) z <locale>, které vrací bool a používá explicitně předaný objekt národního prostředí. Následující příklad předpokládá, že použité hodnoty jsou po převodu na unsigned char reprezentovatelné jako int. Nastaví LC_CTYPE na "C" a vypíše výsledek převedený na bool, takže očekávaný výstup nezávisí na konkrétní nenulové hodnotě vrácené knihovnou.
Pří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ýsledek
A: 1 z: 1 7: 0 _: 0
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.