CKTIS / C++
std::isalpha — preverjanje, ali je znak črka
std::isalpha iz <cctype> preveri, ali vrednost glede na trenutne območne nastavitve C predstavlja črko. Vrne int: nič ali neničelno vrednost. Vrednost tipa char pretvorite v unsigned char in rezultat podajte le, če ga je mogoče predstaviti s tipom int.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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 iz <cctype> razvrsti eno vrednost znaka glede na kategorijo LC_CTYPE trenutnih območnih nastavitev C. Vrne int: neničelno vrednost za črko in 0 sicer. Preverjajte != 0, ne == 1 — resničen rezultat ni nujno enak 1.
Vrednost, podana parametru tipa int, mora biti enaka EOF ali predstavljiva s tipom unsigned char; druge vrednosti povzročijo nedefinirano vedenje. Pri spremenljivki char ch zgolj pretvorba v int ne popravi negativne vrednosti tipa char. Najprej izračunajte static_cast<unsigned char>(ch). Klic std::isalpha(static_cast<unsigned char>(ch)) je varen za vsak ch, če velja UCHAR_MAX <= INT_MAX. Če velja UCHAR_MAX > INT_MAX, pred pretvorbo v int preverite, ali dobljena vrednost ne presega INT_MAX (obe meji sta določeni v <climits>). Vrednosti, večje od INT_MAX, ni mogoče podati nespremenjene: pretvorba lahko da EOF ali drugo negativno vrednost, ki povzroči nedefinirano vedenje. Za tak bajt funkcije ne kličite. Rezultat vhodne funkcije, ki vrača int, ohranite kot int in pred pretvorbo bajta preverite, ali je enak EOF.
Pri območnih nastavitvah "C" so črke A–Z in a–z; druge nastavitve lahko prepoznajo dodatne črke. Funkcija ne dekodira UTF-8: razvrščanje posameznih bajtov ne določa, ali je večbajtni znak Unicode črka.
Te funkcije ne zamenjujte z dvoargumentno funkcijo std::isalpha(ch, loc) iz <locale>, ki vrača bool in uporablja izrecno podani objekt območnih nastavitev. Spodnji primer predpostavlja, da so uporabljene vrednosti po pretvorbi v unsigned char predstavljive s tipom int. Nastavi LC_CTYPE na "C" in izpiše rezultat po pretvorbi v bool, zato pričakovani izpis ni odvisen od konkretne neničelne vrednosti, ki jo vrne knjižnica.
Primeri
#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';
}
}
Rezultat
A: 1 z: 1 7: 0 _: 0
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.