.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de) .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\" Modified Sat Jul 24 19:10:00 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Sun Aug 21 17:51:50 1994 by Rik Faith (faith@cs.unc.edu) .\" Modified Sat Sep 2 21:52:01 1995 by Jim Van Zandt .\" Modified Mon May 27 22:55:26 1996 by Martin Schulze (joey@linux.de) .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ISALPHA 3 "15 septembre 2017" GNU "Manuel du programmeur Linux" .SH 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 caractères .SH SYNOPSIS .nf \fB#include \fP .PP \fBint isalnum(int \fP\fIc\fP\fB);\fP \fBint isalpha(int \fP\fIc\fP\fB);\fP \fBint iscntrl(int \fP\fIc\fP\fB);\fP \fBint isdigit(int \fP\fIc\fP\fB);\fP \fBint isgraph(int \fP\fIc\fP\fB);\fP \fBint islower(int \fP\fIc\fP\fB);\fP \fBint isprint(int \fP\fIc\fP\fB);\fP \fBint ispunct(int \fP\fIc\fP\fB);\fP \fBint isspace(int \fP\fIc\fP\fB);\fP \fBint isupper(int \fP\fIc\fP\fB);\fP \fBint isxdigit(int \fP\fIc\fP\fB);\fP .PP \fBint isascii(int \fP\fIc\fP\fB);\fP \fBint isblank(int \fP\fIc\fP\fB);\fP .PP \fBint isalnum_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP \fBint isalpha_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP \fBint isblank_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP \fBint iscntrl_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP \fBint isdigit_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP \fBint isgraph_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP \fBint islower_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP \fBint isprint_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP \fBint ispunct_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP \fBint isspace_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP \fBint isupper_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP \fBint isxdigit_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP .PP \fBint isascii_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP .fi .PP .RS -4 Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7))\ : .RE .PP .ad l \fBisascii\fP()\ : .RS 4 _XOPEN_SOURCE || /* Depuis la glibc\ 2.19\ : */ _DEFAULT_SOURCE || /* Versions de la glibc\ <=\ 2.19\ : */ _SVID_SOURCE .RE .PP \fBisblank\fP()\ : .RS 4 _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L .RE .PP \fBisalnum_l\fP(), \fBisalpha_l\fP(), \fBisblank_l\fP(), \fBiscntrl_l\fP(), \fBisdigit_l\fP(), \fBisgraph_l\fP(), \fBislower_l\fP(), \fBisprint_l\fP(), \fBispunct_l\fP(), \fBisspace_l\fP(), \fBisupper_l\fP(), \fBisxdigit_l\fP()\ : .PD 0 .RS 4 .TP Depuis la glibc 2.10 : _XOPEN_SOURCE\ >=\ 700 .TP Avant la glibc 2.10 : _GNU_SOURCE .RE .PD .PP \fBisascii_l\fP()\ : .PD 0 .RS 4 .TP Depuis la glibc 2.10 : _XOPEN_SOURCE\ >=\ 700 && (_SVID_SOURCE || _BSD_SOURCE) .TP Avant la glibc 2.10 : _GNU_SOURCE .RE .PD .ad .SH DESCRIPTION Ces fonctions vérifient si le caractère \fIc\fP, qui doit avoir la valeur d'un \fIunsigned char\fP ou valoir \fBEOF\fP, entre dans une catégorie donnée d’après les paramètres régionaux indiqués. Les fonctions sans suffixe «\ _l\ » réalisent les vérifications à partir des paramètres régionaux actuels. .PP Les fonctions avec le suffixe «\ _l\ » réalisent les vérifications à partir des paramètres régionaux indiqués par l’objet de paramètres régionaux \fIlocale\fP. Le comportement de ces fonctions est non défini si \fIlocale\fP est l’objet de paramètres régionaux \fBLC_GLOBAL_LOCALE\fP (consultez \fBduplocale\fP(3)) ou n’est pas un identifiant d’objet de paramètres régionaux valable. .PP La liste suivante explique les opérations des fonctions sans le suffixe «\ _l\ ». Les fonctions avec le suffixe «\ _l\ » ne changent qu’en utilisant l’objet de paramètres régionaux \fIlocale\fP au lieu des paramètres régionaux actuels. .TP \fBisalnum\fP() vérifie s’il s’agit d’un caractère alphanumérique. C'est équivalent à \fB(isalpha(\fP\fIc\fP\fB) || isdigit(\fP\fIc\fP\fB))\fP. .TP \fBisalpha\fP() vérifie s’il s’agit d’un caractère alphabétique. Avec les paramètres régionaux \fB"C"\fP standards, c'est équivalent à \fB(isupper(\fP\fIc\fP\fB) || islower(\fP\fIc\fP\fB))\fP. Avec certains paramètres régionaux, \fBisalpha\fP() peut être vrai pour des caractères supplémentaires, c'est\-à\-dire pour des lettres qui ne sont ni majuscules ni minuscules. .TP \fBisascii\fP() vérifie si \fIc\fP est un \fIunsigned char\fP sur 7 bits, entrant dans le jeu de caractères ASCII. .TP \fBisblank\fP() vérifie s’il s’agit d’un blanc, c'est\-à\-dire un espace ou une tabulation. .TP \fBiscntrl\fP() vérifie s’il s’agit d’un caractère de contrôle. .TP \fBisdigit\fP() vérifie s’il s’agit d’un chiffre (de \fB0\fP à \fB9\fP). .TP \fBisgraph\fP() vérifie s'il s'agit d'un caractère imprimable, à l'exception de l'espace. .TP \fBislower\fP() vérifie s’il s’agit d’un caractère minuscule. .TP \fBisprint\fP() vérifie s'il s'agit d'un caractère imprimable, y compris l'espace. .TP \fBispunct\fP() vérifie s'il s'agit d'un caractère imprimable, qui ne soit ni un espace, ni un caractère alphanumérique. .TP \fBisspace\fP() vérifie s’il s’agit d’un blanc. Dans les paramètres régionaux \fB"C"\fP et \fB"POSIX"\fP il s'agit de\ : espace, saut de page (\fB\(aq\ef\(aq\fP), changement de ligne (\fB\(aq\en\(aq\fP), retour chariot (\fB\(aq\er\(aq\fP), tabulation horizontale (\fB\(aq\et\(aq\fP) et tabulation verticale (\fB\(aq\ev\(aq\fP). .TP \fBisupper\fP() vérifie s’il s’agit d’une lettre majuscule. .TP \fBisxdigit\fP() vérifie s'il s'agit d'un chiffre hexadécimal, c'est\-à\-dire .br \fB0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F\fP. .SH "VALEUR RENVOYÉE" Les valeurs renvoyées sont non nulles si le caractère \fIc\fP entre dans la catégorie testée, et sinon zéro. .SH VERSIONS Les fonctions \fBisalnum_l\fP(), \fBisalpha_l\fP(), \fBisblank_l\fP(), \fBiscntrl_l\fP(), \fBisdigit_l\fP(), \fBisgraph_l\fP(), \fBislower_l\fP(), \fBisprint_l\fP(), \fBispunct_l\fP(), \fBisspace_l\fP(), \fBisupper_l\fP(), \fBisxdigit_l\fP() et \fBisascii_l\fP() sont disponibles depuis la glibc\ 2.3. .SH ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .ad l .TS allbox; lbw32 lb lb l l l. Interface Attribut Valeur T{ \fBisalnum\fP(), \fBisalpha\fP(), \fBisascii\fP(), \fBisblank\fP(), \fBiscntrl\fP(), \fBisdigit\fP(), \fBisgraph\fP(), \fBislower\fP(), \fBisprint\fP(), \fBispunct\fP(), \fBisspace\fP(), \fBisupper\fP(), \fBisxdigit\fP() T} Sécurité des threads MT\-Safe .TE .ad .\" FIXME: need a thread-safety statement about the *_l functions .SH CONFORMITÉ C89 spécifie \fBisalnum\fP(), \fBisalpha\fP(), \fBiscntrl\fP(), \fBisdigit\fP(), \fBisgraph\fP(), \fBislower\fP(), \fBisprint\fP(), \fBispunct\fP(), \fBisspace\fP(), \fBisupper\fP() et \fBisxdigit\fP(), mais ni \fBisascii\fP(), ni \fBisblank\fP(). POSIX.1\-2001 spécifie aussi ces fonctions, ainsi que \fBisascii\fP() (comme extension XSI) et \fBisblank\fP(). C99 spécifie toutes les fonctions précédentes sauf \fBisascii\fP(). .PP POSIX.1\-2008 marque \fBisascii\fP() comme étant obsolète, en notant qu'elle ne peut pas être utilisée de façon portable pour une application localisée. .PP POSIX.1\-2008 spécifie \fBisalnum_l\fP(), \fBisalpha_l\fP(), \fBisblank_l\fP(), \fBiscntrl_l\fP(), \fBisdigit_l\fP(), \fBisgraph_l\fP(), \fBislower_l\fP(), \fBisprint_l\fP(), \fBispunct_l\fP(), \fBisspace_l\fP(), \fBisupper_l\fP() et \fBisxdigit_l\fP(). .PP \fBisascii_l\fP() est une extension GNU. .SH NOTES Les standards requièrent que l'argument \fIc\fP de ces fonctions soit \fBEOF\fP ou une valeur représentable par un \fIunsigned char\fP. Si l'argument \fIc\fP est de type \fIchar\fP, il doit faire l'objet d'une conversion forcée en \fIunsigned char\fP comme montré dans l'exemple suivant\ : .PP .in +4n .EX char c; \&... res = toupper((unsigned char) c); .EE .in .PP Cela est nécessaire car \fIchar\fP pourrait être équivalent à \fIsigned char\fP. Dans ce cas, un octet dont le premier bit serait utilisé aurait une extension de signe lors d'une conversion en \fIint\fP, résultant en une valeur en dehors de l'intervalle des \fIunsigned char\fP. .PP L'appartenance d'un caractère à une catégorie dépend des paramètres régionaux. Par exemple \fBisupper\fP() ne reconnaîtra pas la lettre majuscule latine e accent aigu (É) comme une majuscule avec les paramètres régionaux \fBC\fP par défaut. .SH "VOIR AUSSI" \fBiswalnum\fP(3), \fBiswalpha\fP(3), \fBiswblank\fP(3), \fBiswcntrl\fP(3), \fBiswdigit\fP(3), \fBiswgraph\fP(3), \fBiswlower\fP(3), \fBiswprint\fP(3), \fBiswpunct\fP(3), \fBiswspace\fP(3), \fBiswupper\fP(3), \fBiswxdigit\fP(3), \fBnewlocale\fP(3), \fBsetlocale\fP(3), \fBtoascii\fP(3), \fBtolower\fP(3), \fBtoupper\fP(3), \fBuselocale\fP(3), \fBascii\fP(7), \fBlocale\fP(7) .SH COLOPHON Cette page fait partie de la publication\ 5.10 du projet \fIman\-pages\fP Linux. Une description du projet et des instructions pour signaler des anomalies et la dernière version de cette page peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man\-pages/. .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Grégoire Scano . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .