isalpha(3) Library Functions Manual isalpha(3) NOM isalnum, isalpha, isascii, isblank, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, isxdigit, isalnum_l, isalpha_l, isascii_l, isblank_l, iscntrl_l, isdigit_l, isgraph_l, islower_l, isprint_l, ispunct_l, isspace_l, isupper_l, isxdigit_l - Fonctions de classification de caracteres BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include int isalnum(int c); int isalpha(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); int isascii(int c); int isblank(int c); int isalnum_l(int c, locale_t locale); int isalpha_l(int c, locale_t locale); int isblank_l(int c, locale_t locale); int iscntrl_l(int c, locale_t locale); int isdigit_l(int c, locale_t locale); int isgraph_l(int c, locale_t locale); int islower_l(int c, locale_t locale); int isprint_l(int c, locale_t locale); int ispunct_l(int c, locale_t locale); int isspace_l(int c, locale_t locale); int isupper_l(int c, locale_t locale); int isxdigit_l(int c, locale_t locale); int isascii_l(int c, locale_t locale); Exigences de macros de test de fonctionnalites pour la glibc (consulter feature_test_macros(7)) : isascii() : _XOPEN_SOURCE || /* glibc >= 2.19 : */ _DEFAULT_SOURCE || /* glibc <= 2.19 : */ _SVID_SOURCE isblank() : _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L salnum_l(), salpha_l(), sblank_l(), scntrl_l(), sdigit_l(), sgraph_l(), slower_l(), sprint_l(), spunct_l(), sspace_l(), supper_l(), sxdigit_l() : Depuis la glibc 2.10 : _XOPEN_SOURCE >= 700 Avant la glibc 2.10 : _GNU_SOURCE isascii_l() : Depuis la glibc 2.10 : _XOPEN_SOURCE >= 700 && (_SVID_SOURCE || _BSD_SOURCE) Avant la glibc 2.10 : _GNU_SOURCE DESCRIPTION Ces fonctions verifient si le caractere c, qui doit avoir la valeur d'un unsigned char ou valoir EOF, entre dans une categorie donnee d'apres les parametres regionaux indiques. Les fonctions sans suffixe << _l >> realisent les verifications a partir des parametres regionaux actuels. Les fonctions avec le suffixe << _l >> realisent les verifications a partir des parametres regionaux indiques par l'objet de parametres regionaux locale. Le comportement de ces fonctions est non defini si locale est l'objet de parametres regionaux LC_GLOBAL_LOCALE (consultez duplocale(3)) ou n'est pas un identifiant d'objet de parametres regionaux valable. La liste suivante explique les operations des fonctions sans le suffixe << _l >>. Les fonctions avec le suffixe << _l >> ne changent qu'en utilisant l'objet de parametres regionaux locale au lieu des parametres regionaux actuels. isalnum() verifie s'il s'agit d'un caractere alphanumerique. C'est equivalent a (isalpha(c) || isdigit(c)). isalpha() verifie s'il s'agit d'un caractere alphabetique. Avec les parametres regionaux << C >> standards, c'est equivalent a (isupper(c) || islower(c)). Avec certains parametres regionaux, isalpha() peut etre vrai pour des caracteres supplementaires, c'est-a-dire pour des lettres qui ne sont ni majuscules ni minuscules. isascii() verifie si c est un unsigned char sur 7 bits, entrant dans le jeu de caracteres ASCII. isblank() verifie s'il s'agit d'un blanc, c'est-a-dire une espace ou une tabulation. iscntrl() verifie s'il s'agit d'un caractere de controle. isdigit() verifie s'il s'agit d'un chiffre (de 0 a 9). isgraph() verifie s'il s'agit d'un caractere imprimable, a l'exception de l'espace. islower() verifie s'il s'agit d'un caractere minuscule. isprint() verifie s'il s'agit d'un caractere imprimable, y compris l'espace. ispunct() verifie s'il s'agit d'un caractere imprimable, qui ne soit ni une espace, ni un caractere alphanumerique. isspace() verifier s'il s'agit d'un blanc. Dans les parametres regionaux << C >> et << POSIX >>, il s'agit de : espace, saut de page (<< \f >>), changement de ligne (<< \n >>), retour chariot (<< \r >>), tabulation horizontale (<< \t >>) et tabulation verticale (<< \v >>). isupper() verifie s'il s'agit d'une lettre majuscule. isxdigit() verifie s'il s'agit d'un chiffre hexadecimal, c'est-a-dire 0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F. VALEUR RENVOYEE Les valeurs renvoyees sont non nulles si le caractere c entre dans la categorie testee, et sinon zero. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +---------------------------------+--------------------------+---------+ |Interface | Attribut | Valeur | +---------------------------------+--------------------------+---------+ |isalnum(), isalpha(), isascii(), | Securite des threads | MT-Safe | |isblank(), iscntrl(), isdigit(), | | | |isgraph(), islower(), isprint(), | | | |ispunct(), isspace(), isupper(), | | | |isxdigit() | | | +---------------------------------+--------------------------+---------+ STANDARDS isalnum() isalpha() iscntrl() isdigit() isgraph() islower() isprint() ispunct() isspace() isupper() isxdigit() isblank() C11, POSIX.1-2008. isascii() isalnum_l() isalpha_l() isblank_l() iscntrl_l() isdigit_l() isgraph_l() islower_l() isprint_l() ispunct_l() isspace_l() isupper_l() isxdigit_l() POSIX.1-2008. isascii_l() GNU. HISTORIQUE isalnum() isalpha() iscntrl() isdigit() isgraph() islower() isprint() ispunct() isspace() isupper() isxdigit() C89, POSIX.1-2001. isblank() C99, POSIX.1-2001. isascii() POSIX.1-2001 (XSI). POSIX.1-2008 la marque comme etant obsolete, en notant qu'elle ne peut pas etre utilisee de facon portable pour une application regionalisee. isalnum_l() isalpha_l() isblank_l() iscntrl_l() isdigit_l() isgraph_l() islower_l() isprint_l() ispunct_l() isspace_l() isupper_l() isxdigit_l() glibc 2.3. POSIX.1-2008. isascii_l() glibc 2.3. PIEGES Les standards exigent que l'argument c de ces fonctions soit EOF ou une valeur representable par un unsigned char ; sinon le comportement n'est pas defini. Si l'argument c est de type char, il doit faire l'objet d'une conversion forcee en unsigned char comme montre dans l'exemple suivant : char c; ... res = toupper((unsigned char) c); Cela est necessaire car char pourrait etre equivalent a signed char. Dans ce cas, un octet dont le premier bit serait utilise aurait une extension de signe lors d'une conversion en int, resultant en une valeur en dehors de l'intervalle des unsigned char. L'appartenance d'un caractere a une categorie depend des parametres regionaux. Par exemple isupper() ne reconnaitra pas la lettre majuscule latine e accent aigu (E) comme une majuscule avec les parametres regionaux C par defaut. VOIR AUSSI iswalnum(3), iswalpha(3), iswblank(3), iswcntrl(3), iswdigit(3), iswgraph(3), iswlower(3), iswprint(3), iswpunct(3), iswspace(3), iswupper(3), iswxdigit(3), newlocale(3), setlocale(3), toascii(3), tolower(3), toupper(3), uselocale(3), ascii(7), locale(7) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot , Gregoire Scano et Jean- Philippe MENGUAL Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.8 2 mai 2024 isalpha(3)