.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" 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 "2 mai 2024" "Pages du manuel de Linux 6.8" .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 BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP .P \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 .P \fBint isascii(int \fP\fIc\fP\fB);\fP \fBint isblank(int \fP\fIc\fP\fB);\fP .P \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 .P \fBint isascii_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP .fi .P .RS -4 Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7)) : .RE .ad l .P \fBisascii\fP() : .nf _XOPEN_SOURCE || /* glibc >= 2.19 : */ _DEFAULT_SOURCE || /* glibc <= 2.19 : */ _SVID_SOURCE .fi .P \fBisblank\fP() : .nf _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L .fi .P \fB\%salnum_l\fP(), \fB\%salpha_l\fP(), \fB\%sblank_l\fP(), \fB\%scntrl_l\fP(), \fB\%sdigit_l\fP(), \fB\%sgraph_l\fP(), \fB\%slower_l\fP(), \fB\%sprint_l\fP(), \fB\%spunct_l\fP(), \fB\%sspace_l\fP(), \fB\%supper_l\fP(), \fB\%sxdigit_l\fP() : .nf Depuis la glibc 2.10 : _XOPEN_SOURCE >= 700 Avant la glibc 2.10 : _GNU_SOURCE .fi .P \fBisascii_l\fP() : .nf Depuis la glibc 2.10 : _XOPEN_SOURCE >= 700 && (_SVID_SOURCE || _BSD_SOURCE) Avant la glibc 2.10 : _GNU_SOURCE .fi .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. .P 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. .P 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 une 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 une espace, ni un caractère alphanumérique. .TP \fBisspace\fP() vérifier 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« \ef »\fP), changement de ligne (\fB« \en »\fP), retour chariot (\fB« \er »\fP), tabulation horizontale (\fB« \et »\fP) et tabulation verticale (\fB« \ev »\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 ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interface Attribut Valeur T{ .na .nh \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 .\" FIXME: need a thread-safety statement about the *_l functions .SH STANDARDS .TP \fBisalnum\fP() .TQ \fBisalpha\fP() .TQ \fBiscntrl\fP() .TQ \fBisdigit\fP() .TQ \fBisgraph\fP() .TQ \fBislower\fP() .TQ \fBisprint\fP() .TQ \fBispunct\fP() .TQ \fBisspace\fP() .TQ \fBisupper\fP() .TQ \fBisxdigit\fP() .TQ \fBisblank\fP() C11, POSIX.1\-2008. .TP \fBisascii\fP() .TQ \fBisalnum_l\fP() .TQ \fBisalpha_l\fP() .TQ \fBisblank_l\fP() .TQ \fBiscntrl_l\fP() .TQ \fBisdigit_l\fP() .TQ \fBisgraph_l\fP() .TQ \fBislower_l\fP() .TQ \fBisprint_l\fP() .TQ \fBispunct_l\fP() .TQ \fBisspace_l\fP() .TQ \fBisupper_l\fP() .TQ \fBisxdigit_l\fP() POSIX.1\-2008. .TP \fBisascii_l\fP() GNU. .SH HISTORIQUE .TP \fBisalnum\fP() .TQ \fBisalpha\fP() .TQ \fBiscntrl\fP() .TQ \fBisdigit\fP() .TQ \fBisgraph\fP() .TQ \fBislower\fP() .TQ \fBisprint\fP() .TQ \fBispunct\fP() .TQ \fBisspace\fP() .TQ \fBisupper\fP() .TQ \fBisxdigit\fP() C89, POSIX.1\-2001. .TP \fBisblank\fP() C99, POSIX.1\-2001. .TP \fBisascii\fP() POSIX.1\-2001 (XSI). .IP POSIX.1\-2008 la marque comme étant obsolète, en notant qu'elle ne peut pas être utilisée de façon portable pour une application régionalisée. .TP \fBisalnum_l\fP() .TQ \fBisalpha_l\fP() .TQ \fBisblank_l\fP() .TQ \fBiscntrl_l\fP() .TQ \fBisdigit_l\fP() .TQ \fBisgraph_l\fP() .TQ \fBislower_l\fP() .TQ \fBisprint_l\fP() .TQ \fBispunct_l\fP() .TQ \fBisspace_l\fP() .TQ \fBisupper_l\fP() .TQ \fBisxdigit_l\fP() glibc 2.3. POSIX.1\-2008. .TP \fBisascii_l\fP() glibc 2.3. .SH PIÈGES Les standards exigent que l'argument \fIc\fP de ces fonctions soit \fBEOF\fP ou une valeur représentable par un \fIunsigned char\fP ; sinon le comportement n'est pas défini. 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 : .P .in +4n .EX char c; \&... res = toupper((unsigned char) c); .EE .in .P 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. .P 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) .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 , Grégoire Scano et Jean-Philippe MENGUAL . .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 .