ISDIGIT

Syntaxe

Paramètres

Description

Cette fonction indique si le caractère est un nombre.

Remarques

• La fonction isdigit() renvoie une valeur différent de zéro si caractere est un chiffre, c'est-à-dire de 0 à 9. Sinon, zéro est renvoyé.
• Définition et utilité : La fonction isdigit est définie dans l'entête <cctype> et permet de vérifier si un caractère donné est un chiffre décimal, c'est-à-dire l'un des caractères '0' à '9'. Cette fonction est utile dans des programmes où il est nécessaire de valider les entrées utilisateur ou de traiter des chaînes de caractères contenant des chiffres.
• Comportement avec les caractères ASCII : isdigit fonctionne spécifiquement avec les chiffres ASCII (caractères de 48 à 57). Elle retourne vrai pour les caractères '0' à '9' et faux pour tous les autres caractères, y compris les lettres, symboles et espaces. Par exemple, isdigit('5') retourne vrai, tandis que isdigit('a') retourne faux.
• Validation de saisie : Un cas d'utilisation courant de isdigit est la validation d'entrées utilisateur, comme vérifier si une chaîne ou un caractère saisi est un chiffre avant de l'utiliser dans des calculs. Par exemple, dans une application de conversion de devises, on peut tester si un caractère est un chiffre avant de l'inclure dans la conversion :
1. char c = '5';
2. if (isdigit(c)) {
3.     std::cout << c << " est un chiffre." << std::endl;
4. } else {
5.     std::cout << c << " n'est pas un chiffre." << std::endl;
6. }


• Manipulation de chaînes de caractères : isdigit est couramment utilisée dans le traitement de chaînes de caractères pour extraire ou valider des chiffres. Par exemple, pour extraire tous les chiffres d'une chaîne, on peut utiliser isdigit dans une boucle :
1. #include <iostream>
2. #include <cctype>
3. #include <string>
4.  
5. int main() {
6.     std::string str = "abc123def45";
7.     for (char c : str) {
8.         if (isdigit(c)) {
9.             std::cout << c << " ";
10.         }
11.     }
12.     return 0;
13. }

Ce programme extraira et affichera les chiffres "1 2 3 4 5".

• Comportement avec les caractères de contrôle : Comme la fonction isdigit ne reconnaît que les chiffres ASCII ('0' à '9'), elle renverra également 0 pour les caractères de contrôle (comme les sauts de ligne ou les tabulations). Cela signifie que des caractères comme '\n' ou '\t' ne sont pas considérés comme des chiffres, même si certains systèmes pourraient les afficher de manière similaire à des chiffres dans certains contextes de traitement.
• Prise en charge des locales : Contrairement à certaines fonctions comme isalpha ou islower, isdigit ne dépend généralement pas des locales dans le cadre des chiffres numériques. Les caractères '0' à '9' sont standards et ne varient pas en fonction de la configuration régionale. Cela simplifie l'utilisation de cette fonction pour la validation des chiffres dans des systèmes multi-lingues.
• Comparaison avec d'autres fonctions de classification : isdigit fait partie d'un groupe de fonctions de classification de caractères en C++ incluant isalpha (pour les lettres), isspace (pour les espaces), et isalnum (pour les lettres et les chiffres). Ces fonctions peuvent être utilisées ensemble pour valider des entrées plus complexes. Par exemple, pour vérifier si une chaîne contient uniquement des chiffres, on peut combiner isdigit avec une boucle pour chaque caractère.
• Utilisation dans le traitement de chaînes : isdigit est souvent utilisée dans les algorithmes traitant des chaînes de caractères pour extraire ou valider les chiffres présents. Par exemple, un programme peut analyser une chaîne de caractères et extraire uniquement les chiffres pour effectuer des calculs ou des analyses. Exemple :
1. #include <iostream>
2. #include <cctype>
3. #include <string>
4.  
5. int main() {
6.     std::string input = "abc123xyz";
7.     for (char c : input) {
8.         if (isdigit(c)) {
9.             std::cout << c << " est un chiffre." << std::endl;
10.         }
11.     }
12.     return 0;
13. }

Cela afficherait "1 est un chiffre", "2 est un chiffre", et "3 est un chiffre".

• Comportement avec les valeurs non valides : L'argument de isdigit doit être un entier représentant un caractère ASCII valide ou EOF. Passer une valeur en dehors de cette plage (par exemple, un entier négatif ou un caractère non défini) peut entraîner un comportement indéfini, particulièrement si la valeur n'est pas représentée par un caractère visible. Il est donc essentiel de s'assurer que l'entrée correspond bien à un caractère valide.
• Utilisation dans des programmes de validation de nombres : isdigit est souvent utilisée dans des programmes validant des entrées numériques. Par exemple, lors de la saisie d'un nombre par l'utilisateur, on peut vérifier que tous les caractères sont des chiffres avant de les convertir en un entier :
1. #include <iostream>
2. #include <cctype>
3. #include <string>
4.  
5. bool isNumber(const std::string& str) {
6.     for (char c : str) {
7.         if (!isdigit(c)) {
8.             return false;  // Contient un caractère non numérique
9.         }
10.     }
11.     return true;  // Tous les caractères sont des chiffres
12. }
13.  
14. int main() {
15.     std::string input = "12345";
16.     if (isNumber(input))
17.         std::cout << input << " est un nombre valide.\n";
18.     else
19.         std::cout << input << " n'est pas un nombre valide.\n";
20.     return 0;
21. }

Ce programme valide que la chaîne contient uniquement des chiffres.

• Performance et simplicité : La fonction isdigit est très rapide et très simple à utiliser. Comme elle n'effectue qu'une comparaison avec les caractères numériques standards (de '0' à '9'), son exécution est optimisée pour des performances élevées, ce qui en fait un excellent choix pour les validations fréquentes dans des applications à grande échelle.

Exemple

Voici quelques exemples typiques de l'utilisation de cette fonction :

Essayer maintenant !

on obtiendra le résultat suivant :

Voir également

Langage de programmation - C - Référence de procédures et fonctions - isdigit

Références

Langage C, Edition Micro-Application, Gehard Willms, 2001, ISBN: 2-7429-2008-0, page 732.
Borland C++ for Windows 4.0, Library Reference, Edition Borland, 1993, Part # BCP1240WW21772, page 152.