isalpha, isalnum, isascii, isblank, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, isxdigit − Routines de classification de caractères.

#include <ctype.h>

int isalnum (int c);
int isalpha (int c);
int isascii (int c);
int isblank (int c);
int iscntrl (int c);
int isdigit (int c);
int isgraph (int c);
int islower (int c);
int isprint (int c);
int ispunct (int c);
int isspace (int c);
int isupper (int c);
int isxdigit (int c);

Ces fonctions vérifient si le caractère c, qui doit avoir la valeur d’un unsigned char ou valoir EOF, rentre dans une catégorie donnée, en accord avec la localisation en cours.

isalnum()

vérifie si l’on a un caractère alphanumérique. C’est équivalent à (isalpha(c) || isdigit(c)).

isalpha()

vérifie si l’on a un caractère alphabétique. Dans la localisation "C" standard, c’est équivalent à (isupper(c) || islower(c)). Dans certaines localisations, il peut y avoir des caractères supplémentaires pour lesquels isalpha() est vrai, c’est-à -dire pour des lettres qui ne sont ni majuscules ni minuscules.

isascii()

vérifie si c est un unsigned char sur 7 bits, entrant dans le jeu de caractères ASCII.

isblank()

vérifie si le caractère est blanc, c’est-à -dire une espace ou une tabulation.

iscntrl()

vérifie si l’on a un caractère de contrôle.

isdigit()

vérifie si l’on a un chiffre (0 à 9).

isgraph()

vérifie s’il s’agit d’un caractère imprimable, à l’exception de l’espace.

islower()

vérifie si l’on a un caractère minuscule.

isprint()

vérifie s’il s’agit d’un caractère imprimable, y compris l’espace.

ispunct()

vérifie s’il s’agit d’un caractère imprimable, qui ne soit ni un espace, ni un caractère alphanumérique.

isspace()

vérifie si l’on a un caractère blanc, d’espacement. Dans les localisations "C" et "POSIX" il s’agit de : espace, saut de page (form-feed, ’\f’), saut de ligne (newline, ’\n’), retour chariot (carriage return, ’\r’), tabulation horizontale (’\t’), et tabulation verticale (’\v’).

isupper()

vérifie si l’on a une lettre majuscule.

isxdigit()

vérifie s’il s’agit d’un chiffre hexadécimal, c’est-à -dire
0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F.

Les valeurs renvoyées sont non nulles si le caractère c entre dans la catégorie testée, et zéro sinon

C99, BSD 4.3. isascii() est une extension BSD et SVr4. isblank() est conforme à POSIX.1-2001 et à la norme C99 7.4.1.3.

L’appartenance d’un caractère à une catégorie dépend de la localisation en cours. Par exemple, islower() ne reconnaîtra pas un e−accent−aigu comme une minuscule dans la localisation C par défaut.

iswalnum(3), iswalpha(3), iswblank(3), iswcntrl(3), iswdigit(3), iswgraph(3), iswlower(3), iswprint(3), iswpunct(3), iswspace(3), iswupper(3), iswxdigit(3), setlocale(3), tolower(3), toupper(3), ascii(7), locale(7)

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 4 novembre 1996 et révisée le 14 août 2006.

L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 isalpha ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.