CKTIS / C++
std::isalpha — verificare se un carattere è una lettera
std::isalpha di <cctype> verifica se un valore rappresenta una lettera in base alle impostazioni locali C correnti. Restituisce int: zero o un valore diverso da zero. Per classificare un valore di tipo char, convertilo in unsigned char e passa il risultato solo se è rappresentabile come int.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#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 di <cctype> classifica un singolo valore di carattere usando la categoria LC_CTYPE delle impostazioni locali C correnti. Restituisce int: un valore diverso da zero per una lettera e 0 altrimenti. Verifica != 0, non == 1: un risultato vero non deve necessariamente essere uguale a 1.
Il valore passato al parametro di tipo int deve essere uguale a EOF oppure rappresentabile come unsigned char; gli altri valori causano comportamento indefinito. Per una variabile char ch, la sola conversione a int non corregge un valore negativo di char. Valuta prima static_cast<unsigned char>(ch). La chiamata std::isalpha(static_cast<unsigned char>(ch)) è sicura per qualsiasi ch se UCHAR_MAX <= INT_MAX. Se UCHAR_MAX > INT_MAX, verifica che il valore ottenuto non superi INT_MAX prima di convertirlo in int (entrambi i limiti sono definiti in <climits>). Un valore superiore a INT_MAX non può essere passato senza alterarlo: la conversione può produrre EOF o un altro valore negativo che causa comportamento indefinito. Non chiamare la funzione per un byte di questo tipo. Mantieni di tipo int il risultato di una funzione di input che restituisce int e verifica se è uguale a EOF prima di convertire il byte.
Nelle impostazioni locali "C", le lettere sono A–Z e a–z; altre impostazioni locali possono riconoscere lettere aggiuntive. La funzione non decodifica UTF-8: classificare singoli byte non determina se un carattere Unicode multibyte è una lettera.
Non confondere questa funzione con std::isalpha(ch, loc) a due argomenti di <locale>, che restituisce bool e usa un oggetto esplicito delle impostazioni locali. L’esempio seguente presuppone che i valori usati siano rappresentabili come int dopo la conversione in unsigned char. Imposta LC_CTYPE su "C" e stampa il risultato dopo averlo normalizzato a bool, così l’output atteso non dipende dal particolare valore diverso da zero restituito dalla libreria.
Esempi
#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';
}
}
Risultato
A: 1 z: 1 7: 0 _: 0
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.