CKTIS / C++
std::isalpha — vérifier si un caractère est une lettre
std::isalpha de <cctype> vérifie si une valeur représente une lettre selon la locale C actuelle. La fonction renvoie int : zéro ou une valeur non nulle. Pour classer une valeur de type char, convertissez-la en unsigned char et ne transmettez le résultat que s’il est représentable par int.
Version : 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 de <cctype> classe une valeur de caractère selon la catégorie LC_CTYPE de la locale C actuelle. La fonction renvoie int : une valeur non nulle pour une lettre et 0 dans le cas contraire. Testez != 0, et non == 1 : un résultat vrai n’est pas nécessairement égal à 1.
La valeur passée au paramètre de type int doit être égale à EOF ou être représentable par unsigned char ; toute autre valeur entraîne un comportement indéfini. Pour une variable char ch, une simple conversion en int ne corrige pas une valeur négative de char. Évaluez d’abord static_cast<unsigned char>(ch). L’appel std::isalpha(static_cast<unsigned char>(ch)) est sûr pour toute valeur de ch si UCHAR_MAX <= INT_MAX. Si UCHAR_MAX > INT_MAX, vérifiez que la valeur obtenue ne dépasse pas INT_MAX avant de la convertir en int (les deux limites sont définies dans <climits>). Une valeur supérieure à INT_MAX ne peut pas être transmise telle quelle : la conversion peut donner EOF ou une autre valeur négative qui entraîne un comportement indéfini. N’appelez pas la fonction pour un tel octet. Conservez en int le résultat d’une fonction d’entrée qui renvoie int et vérifiez s’il vaut EOF avant de convertir l’octet.
Dans la locale "C", les lettres sont A–Z et a–z ; d’autres locales peuvent reconnaître des lettres supplémentaires. La fonction ne décode pas UTF-8 : classer les octets séparément ne permet pas de déterminer si un caractère Unicode multioctet est une lettre.
Ne confondez pas cette fonction avec std::isalpha(ch, loc) à deux arguments de <locale>, qui renvoie bool et utilise un objet de locale explicite. L’exemple ci-dessous suppose que les valeurs utilisées sont représentables par int après conversion en unsigned char. Il définit LC_CTYPE sur "C" et affiche le résultat après conversion en bool, de sorte que la sortie attendue ne dépende pas de la valeur non nulle particulière renvoyée par la bibliothèque.
Exemples
#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';
}
}
Résultat
A: 1 z: 1 7: 0 _: 0
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.