CKTIS / C++
std::isalpha — provjera je li znak slovo
std::isalpha iz <cctype> provjerava predstavlja li vrijednost slovo prema trenutačnim lokalnim postavkama C. Vraća int: nulu ili vrijednost različitu od nule. Vrijednost tipa char pretvorite u unsigned char i proslijedite rezultat samo ako se može prikazati tipom int.
Verzija: 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> klasificira jednu vrijednost znaka prema kategoriji LC_CTYPE trenutačnih lokalnih postavki C. Vraća int: vrijednost različitu od nule za slovo, a 0 u suprotnom. Provjeravajte != 0, a ne == 1 — istinit rezultat ne mora biti jednak 1.
Vrijednost proslijeđena parametru tipa int mora biti jednaka EOF ili prikaziva tipom unsigned char; druge vrijednosti uzrokuju nedefinirano ponašanje. Za varijablu char ch sama pretvorba u int ne popravlja negativnu vrijednost tipa char. Najprije izračunajte static_cast<unsigned char>(ch). Poziv std::isalpha(static_cast<unsigned char>(ch)) siguran je za svaki ch ako vrijedi UCHAR_MAX <= INT_MAX. Ako vrijedi UCHAR_MAX > INT_MAX, prije pretvorbe u int provjerite da dobivena vrijednost ne prelazi INT_MAX (obje su granice definirane u <climits>). Vrijednost veću od INT_MAX nije moguće proslijediti nepromijenjenu: pretvorba može dati EOF ili drugu negativnu vrijednost koja uzrokuje nedefinirano ponašanje. Za takav bajt nemojte pozivati funkciju. Rezultat ulazne funkcije koja vraća int zadržite kao int i prije pretvorbe bajta provjerite je li jednak EOF.
U lokalnim postavkama "C" slova su A–Z i a–z; druge postavke mogu prepoznati dodatna slova. Funkcija ne dekodira UTF-8: klasificiranje pojedinačnih bajtova ne određuje je li višebajtni Unicode znak slovo.
Nemojte zamijeniti ovu funkciju s dvoargumentnom funkcijom std::isalpha(ch, loc) iz <locale>, koja vraća bool i upotrebljava izričito naveden objekt lokalnih postavki. Primjer u nastavku pretpostavlja da se upotrijebljene vrijednosti nakon pretvorbe u unsigned char mogu prikazati tipom int. Postavlja LC_CTYPE na "C" i ispisuje rezultat nakon normalizacije u bool, pa očekivani izlaz ne ovisi o konkretnoj vrijednosti različitoj od nule koju vraća biblioteka.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.