Partager via


is, isw Routines

isalnum, iswalnum, _isalnum_l, _iswalnum_l

islower, iswlower, _islower_l, _iswlower_l

isalpha, iswalpha, _isalpha_l, _iswalpha_l

isprint, iswprint, _isprint_l, _iswprint_l

__isascii, iswascii

ispunct, iswpunct, _ispunct_l, _iswpunct_l

iscntrl, iswcntrl, _iscntrl_l, _iswcntrl_l

isspace, iswspace, _isspace_l, _iswspace_l

__iscsym, __iscsymf de __iswcsym, __iswcsymf

isupper, _isupper_l, iswupper, _iswupper_l

isdigit, iswdigit, _isdigit_l, _iswdigit_l

_isctype, iswctype, _isctype_l, _iswctype_l

isgraph, iswgraph, _isgraph_l, _iswgraph_l

isxdigit, iswxdigit, _isxdigit_l, _iswxdigit_l

isleadbyte, _isleadbyte_l

Notes

Ces caractères de test individuel de série pour les conditions spécifiées.

Les routines d' est produisent des résultats significatifs pour tout argument entier )de 1 (EOF) à UCHAR_MAX (0xFF), inclus.Le type d'argument attendu est int.

Mise en gardeAttention

Pour les routines d' est , passer un argument de type char peut générer des résultats imprévisibles.Un caractère codé sur un octet unique SBCS ou MBCS de type char avec une valeur supérieure à 0x7F est négatif.Si char est passé, le compilateur peut convertir la valeur en int signé ou à longsigné.Cette valeur peut signe-être étendu par le compilateur, avec des résultats inattendus.

les résultats significatifs de produit de routines d' isw pour toute valeur entière - de 1 (WEOF) à 0xFFFF, inclus.le type de données de wint_t est défini dans WCHAR.H comme unsigned short; il peut contenir n'importe quel caractère élargi ou la valeur de fin de fichier à caractères larges (WEOF).

la valeur de sortie est affectée par le paramètre du paramètre de catégorie d' LC_CTYPE des paramètres régionaux ; consultez setlocale pour plus d'informations.Les versions de ces fonctions sans le suffixe de _l utilisent les paramètres régionaux définis pour ce comportement dépendant des paramètres régionaux ; les versions avec le suffixe " _l sont identiques mais elles utilisent le paramètre de paramètres régionaux passé à la place.

Dans les paramètres régionaux « C », les conditions de test pour les routines d' est sont les suivantes :

  • isalnum
    Alphanumérique (A à Z, a et z, ou 0 - 9).

  • isalpha
    Alphabétique (une classe (Z ou a à z).

  • __isascii
    caractère ASCII (0x00 - 0x7F).

  • iscntrl
    Caractère de contrôle (0x00 - 0x1F ou 0x7F).

  • __iscsym
    Lettre, trait de soulignement, ou un chiffre.

  • __iscsymf
    Caractère alphabétique ou un trait de soulignement.

  • isdigit
    chiffre décimal (0 - 9).

  • isgraph
    Caractère imprimable à l'exception de l'espace ().

  • islower
    Minuscule (a à z).

  • isprint
    Caractère imprimable notamment l'espace (0x20 - 0x7E).

  • ispunct
    Caractère de ponctuation.

  • isspace
    Espace blanc (0x09 - 0x0D ou 0x20).

  • isupper
    Majuscule (A à Z).

  • isxdigit
    Chiffre hexadécimal (une classe (F, une classe (f, ou 0 - 9).

Pour les routines d' isw , le résultat du test pour l'état spécifié est indépendante des paramètres régionaux.Les conditions de test pour les fonctions d' isw sont les suivantes :

  • iswalnum
    iswalpha ou iswdigit.

  • iswalpha
    Tout caractère élargi qui est un d'un ensemble implémentation-défini pour lequel aucun d' iswcntrl, d' iswdigit, d' iswpunct, ou d' iswspace n'est différent de zéro.iswalpha retourne une valeur différente de zéro uniquement pour les caractères élargis pour lesquels iswupper ou iswlower est différent de zéro.

  • iswascii
    représentation de caractères du caractère ASCII (0x0000 - 0x007F).

  • iswcntrl
    Caractère élargi de contrôle.

  • __iswcsym
    Tout caractère élargi pour lequel isalnum est vraie, ou le caractère « _ ».

  • __iswcsymf
    Tout caractère élargi pour lequel iswalpha est vraie, ou le caractère « _ ».

  • iswctype
    Le caractère possède la propriété spécifiée par l'argument d' desc .Pour chaque valeur valide de l'argument d' desc d' iswctype, il existe une routine à caractère élargi équivalente classification, comme indiqué dans le tableau suivant :

    équivalence d'iswctype ( c, desc ) à d'autres routines de test d'isw

    Valeur de l'argument de desc

    équivalent de l'iswctype ( c, desc )

    _ALPHA

    iswalpha ( c )

    _ALPHA | _DIGIT

    iswalnum ( c )

    _CONTROL

    iswcntrl ( c )

    _DIGIT

    iswdigit ( c )

    _ALPHA | _DIGIT | _PUNCT

    iswgraph ( c )

    _LOWER

    iswlower ( c )

    _ALPHA | _BLANK | _DIGIT | _PUNCT

    iswprint ( c )

    _PUNCT

    iswpunct ( c )

    _SPACE

    iswspace ( c )

    _UPPER

    iswupper ( c )

    _HEX

    iswxdigit ( c )

  • iswdigit
    Caractère élargi correspondant à un caractère de décimale-chiffre.

  • iswgraph
    Caractère élargi imprimable sauf le caractère large (L ').

  • iswlower
    Minuscule, ou l'une de l'ensemble implémentation-défini à caractères larges pour lesquelles aucun d' iswcntrl, d' iswdigit, d' iswpunct, ou d' iswspace n'est différent de zéro.iswlower retourne une valeur différente de zéro uniquement pour les caractères larges qui correspondent aux casse.

  • iswprint
    Caractère élargi imprimable, y compris le caractère large (L ').

  • iswpunct
    Caractère élargi imprimable qui n'est ni caractères larges (L ') ni caractère élargi pour lequel iswalnum est différent de zéro.

  • iswspace
    Caractère élargi correspondant au caractère d'espace blanc standard ou est un de l'ensemble implémentation-défini à caractères larges pour lesquels iswalnum est false.Les espaces blancs standard sont : l'espace (L "), saut de page ( » de L'F'\), Newline (L'\ N'), Carriage Return (L'\ R'), Horizontal TAB (L'\ Vous), Et Vertical TAB (L'\ v).

  • iswupper
    Caractère élargi qui est en majuscules ou est un d'un ensemble implémentation-défini à caractères larges pour lesquelles aucun d' iswcntrl, d' iswdigit, d' iswpunct, ou d' iswspace n'est différent de zéro.iswupper retourne une valeur différente de zéro uniquement pour les caractères larges qui correspondent aux majuscules.

  • iswxdigit
    Caractère élargi correspondant à un caractère de hexadécimal-chiffre.

Exemple

// crt_isfam.c
/* This program tests all characters between 0x0
 * and 0x7F, then displays each character with abbreviations
 * for the character-type codes that apply.
 */

#include <stdio.h>
#include <ctype.h>

int main( void )
{
   int ch;
   for( ch = 0; ch <= 0x7F; ch++ )
   {
      printf( "%.2x  ", ch );
      printf( " %c", isprint( ch )  ? ch   : ' ' );
      printf( "%4s", isalnum( ch )  ? "AN" : "" );
      printf( "%3s", isalpha( ch )  ? "A"  : "" );
      printf( "%3s", __isascii( ch )  ? "AS" : "" );
      printf( "%3s", iscntrl( ch )  ? "C"  : "" );
      printf( "%3s", __iscsym( ch )  ? "CS "  : "" );
      printf( "%3s", __iscsymf( ch )  ? "CSF"  : "" );
      printf( "%3s", isdigit( ch )  ? "D"  : "" );
      printf( "%3s", isgraph( ch )  ? "G"  : "" );
      printf( "%3s", islower( ch )  ? "L"  : "" );
      printf( "%3s", ispunct( ch )  ? "PU" : "" );
      printf( "%3s", isspace( ch )  ? "S"  : "" );
      printf( "%3s", isprint( ch )  ? "PR" : "" );
      printf( "%3s", isupper( ch )  ? "U"  : "" );
      printf( "%3s", isxdigit( ch ) ? "X"  : "" );
      printf( ".\n" );
   }
}

Sortie

00            AS  C                              .
01            AS  C                              .
02            AS  C                              .
03            AS  C                              .
04            AS  C                              .
05            AS  C                              .
06            AS  C                              .
07            AS  C                              .
08            AS  C                              .
09            AS  C                    S         .
0a            AS  C                    S         .
0b            AS  C                    S         .
0c            AS  C                    S         .
0d            AS  C                    S         .
0e            AS  C                              .
0f            AS  C                              .
10            AS  C                              .
11            AS  C                              .
12            AS  C                              .
13            AS  C                              .
14            AS  C                              .
15            AS  C                              .
16            AS  C                              .
17            AS  C                              .
18            AS  C                              .
19            AS  C                              .
1a            AS  C                              .
1b            AS  C                              .
1c            AS  C                              .
1d            AS  C                              .
1e            AS  C                              .
1f            AS  C                              .
20            AS                       S PR      .
21   !        AS              G    PU    PR      .
22   "        AS              G    PU    PR      .
23   #        AS              G    PU    PR      .
24   $        AS              G    PU    PR      .
25   %        AS              G    PU    PR      .
26   &        AS              G    PU    PR      .
27   '        AS              G    PU    PR      .
28   (        AS              G    PU    PR      .
29   )        AS              G    PU    PR      .
2a   *        AS              G    PU    PR      .
2b   +        AS              G    PU    PR      .
2c   ,        AS              G    PU    PR      .
2d   -        AS              G    PU    PR      .
2e   .        AS              G    PU    PR      .
2f   /        AS              G    PU    PR      .
30   0  AN    AS   CS      D  G          PR     X.
31   1  AN    AS   CS      D  G          PR     X.
32   2  AN    AS   CS      D  G          PR     X.
33   3  AN    AS   CS      D  G          PR     X.
34   4  AN    AS   CS      D  G          PR     X.
35   5  AN    AS   CS      D  G          PR     X.
36   6  AN    AS   CS      D  G          PR     X.
37   7  AN    AS   CS      D  G          PR     X.
38   8  AN    AS   CS      D  G          PR     X.
39   9  AN    AS   CS      D  G          PR     X.
3a   :        AS              G    PU    PR      .
3b   ;        AS              G    PU    PR      .
3c   <        AS              G    PU    PR      .
3d   =        AS              G    PU    PR      .
3e   >        AS              G    PU    PR      .
3f   ?        AS              G    PU    PR      .
40   @        AS              G    PU    PR      .
41   A  AN  A AS   CS CSF     G          PR  U  X.
42   B  AN  A AS   CS CSF     G          PR  U  X.
43   C  AN  A AS   CS CSF     G          PR  U  X.
44   D  AN  A AS   CS CSF     G          PR  U  X.
45   E  AN  A AS   CS CSF     G          PR  U  X.
46   F  AN  A AS   CS CSF     G          PR  U  X.
47   G  AN  A AS   CS CSF     G          PR  U   .
48   H  AN  A AS   CS CSF     G          PR  U   .
49   I  AN  A AS   CS CSF     G          PR  U   .
4a   J  AN  A AS   CS CSF     G          PR  U   .
4b   K  AN  A AS   CS CSF     G          PR  U   .
4c   L  AN  A AS   CS CSF     G          PR  U   .
4d   M  AN  A AS   CS CSF     G          PR  U   .
4e   N  AN  A AS   CS CSF     G          PR  U   .
4f   O  AN  A AS   CS CSF     G          PR  U   .
50   P  AN  A AS   CS CSF     G          PR  U   .
51   Q  AN  A AS   CS CSF     G          PR  U   .
52   R  AN  A AS   CS CSF     G          PR  U   .
53   S  AN  A AS   CS CSF     G          PR  U   .
54   T  AN  A AS   CS CSF     G          PR  U   .
55   U  AN  A AS   CS CSF     G          PR  U   .
56   V  AN  A AS   CS CSF     G          PR  U   .
57   W  AN  A AS   CS CSF     G          PR  U   .
58   X  AN  A AS   CS CSF     G          PR  U   .
59   Y  AN  A AS   CS CSF     G          PR  U   .
5a   Z  AN  A AS   CS CSF     G          PR  U   .
5b   [        AS              G    PU    PR      .
5c   \        AS              G    PU    PR      .
5d   ]        AS              G    PU    PR      .
5e   ^        AS              G    PU    PR      .
5f   _        AS   CS CSF     G    PU    PR      .
60   `        AS              G    PU    PR      .
61   a  AN  A AS   CS CSF     G  L       PR     X.
62   b  AN  A AS   CS CSF     G  L       PR     X.
63   c  AN  A AS   CS CSF     G  L       PR     X.
64   d  AN  A AS   CS CSF     G  L       PR     X.
65   e  AN  A AS   CS CSF     G  L       PR     X.
66   f  AN  A AS   CS CSF     G  L       PR     X.
67   g  AN  A AS   CS CSF     G  L       PR      .
68   h  AN  A AS   CS CSF     G  L       PR      .
69   i  AN  A AS   CS CSF     G  L       PR      .
6a   j  AN  A AS   CS CSF     G  L       PR      .
6b   k  AN  A AS   CS CSF     G  L       PR      .
6c   l  AN  A AS   CS CSF     G  L       PR      .
6d   m  AN  A AS   CS CSF     G  L       PR      .
6e   n  AN  A AS   CS CSF     G  L       PR      .
6f   o  AN  A AS   CS CSF     G  L       PR      .
70   p  AN  A AS   CS CSF     G  L       PR      .
71   q  AN  A AS   CS CSF     G  L       PR      .
72   r  AN  A AS   CS CSF     G  L       PR      .
73   s  AN  A AS   CS CSF     G  L       PR      .
74   t  AN  A AS   CS CSF     G  L       PR      .
75   u  AN  A AS   CS CSF     G  L       PR      .
76   v  AN  A AS   CS CSF     G  L       PR      .
77   w  AN  A AS   CS CSF     G  L       PR      .
78   x  AN  A AS   CS CSF     G  L       PR      .
79   y  AN  A AS   CS CSF     G  L       PR      .
7a   z  AN  A AS   CS CSF     G  L       PR      .
7b   {        AS              G    PU    PR      .
7c   |        AS              G    PU    PR      .
7d   }        AS              G    PU    PR      .
7e   ~        AS              G    PU    PR      .
7f            AS  C                              .

Voir aussi

Référence

Classification des caractères

Paramètres régionaux

setlocale, _wsetlocale

Interprétation des séquences de caractères multioctets

to fonctions