is, isw Routinesis, isw Routines

isalnum, iswalnum, _isalnum_l, _iswalnum_lisalnum, iswalnum, _isalnum_l, _iswalnum_l isgraph, iswgraph, _isgraph_l, _iswgraph_lisgraph, iswgraph, _isgraph_l, _iswgraph_l
isalpha, iswalpha, _isalpha_l, _iswalpha_lisalpha, iswalpha, _isalpha_l, _iswalpha_l isleadbyte, _isleadbyte_lisleadbyte, _isleadbyte_l
isascii, __isascii, iswasciiisascii, __isascii, iswascii islower, iswlower, _islower_l, _iswlower_lislower, iswlower, _islower_l, _iswlower_l
isblank, iswblank, _isblank_l, _iswblank_lisblank, iswblank, _isblank_l, _iswblank_l isprint, iswprint, _isprint_l, _iswprint_lisprint, iswprint, _isprint_l, _iswprint_l
iscntrl, iswcntrl, _iscntrl_l, _iswcntrl_liscntrl, iswcntrl, _iscntrl_l, _iswcntrl_l ispunct, iswpunct, _ispunct_l, _iswpunct_lispunct, iswpunct, _ispunct_l, _iswpunct_l
iscsym, iscsymf, __iscsym, __iswcsym, __iscsymf, __iswcsymf, _iscsym_l, _iswcsym_l, _iscsymf_l, _iswcsymf_liscsym, iscsymf, __iscsym, __iswcsym, __iscsymf, __iswcsymf, _iscsym_l, _iswcsym_l, _iscsymf_l, _iswcsymf_l isspace, iswspace, _isspace_l, _iswspace_lisspace, iswspace, _isspace_l, _iswspace_l
_isctype, iswctype, _isctype_l, _iswctype_l_isctype, iswctype, _isctype_l, _iswctype_l isupper, _isupper_l, iswupper, _iswupper_lisupper, _isupper_l, iswupper, _iswupper_l
isdigit, iswdigit, _isdigit_l, _iswdigit_lisdigit, iswdigit, _isdigit_l, _iswdigit_l isxdigit, iswxdigit, _isxdigit_l, _iswxdigit_lisxdigit, iswxdigit, _isxdigit_l, _iswxdigit_l

NoteRemarks

Queste routine verificano che i caratteri soddisfino le condizioni specificate.These routines test characters for specified conditions.

Le routine is producono risultati significativi per qualsiasi argomento Integer compreso tra -1 (EOF) e UCHAR_MAX (0xFF), inclusi.The is routines produce meaningful results for any integer argument from -1 (EOF) to UCHAR_MAX (0xFF), inclusive. Il tipo di argomento previsto è int.The expected argument type is int.

Attenzione

Per le routine is, il passaggio di un argomento di tipo char potrebbe generare risultati imprevedibili.For the is routines, passing an argument of type char may yield unpredictable results. Un carattere a un byte SBCS o MBCS di tipo char con un valore maggiore di 0x7F è negativo.An SBCS or MBCS single-byte character of type char with a value greater than 0x7F is negative. Se viene passato un tipo char, è possibile che il compilatore converta il valore in un int o long con segno.If a char is passed, the compiler may convert the value to a signed int or a signed long. Il valore potrebbe essere esteso con segno dal compilatore, con risultati non previsti.This value may be sign-extended by the compiler, with unexpected results.

Le routine isw producono risultati significativi per qualsiasi valore Integer compreso tra -1 (WEOF) e 0xFFFF, inclusi.The isw routines produce meaningful results for any integer value from - 1 (WEOF) to 0xFFFF, inclusive. Il tipo di dati wint_t è definito in WCHAR.H come unsigned short. Può usare qualsiasi carattere wide o valore wide di fine del file (WEOF).The wint_t data type is defined in WCHAR.H as an unsigned short; it can hold any wide character or the wide-character end-of-file (WEOF) value.

La configurazione dell'impostazione della categoria LC_CTYPE delle impostazioni locali influisce sul valore di output. Per altre informazioni, vedere setlocale.The output value is affected by the setting of the LC_CTYPE category setting of the locale; see setlocale for more information. Le versioni di queste funzioni senza il suffisso _l usano le impostazioni locali correnti per questo comportamento dipendente dalle impostazioni locali. Le versioni con il suffisso _l sono identiche, ma usano il parametro passato alle impostazioni locali.The versions of these functions without the _l suffix use the current locale for this locale-dependent behavior; the versions with the _l suffix are identical except that they use the locale parameter passed in instead.

Nelle impostazioni locali "C" le condizioni di test per le routine is sono quelle specificate di seguito:In the "C" locale, the test conditions for the is routines are as follows:

isalnum
Alfanumerico (A - Z, a - z o 0 - 9).Alphanumeric (A - Z, a - z, or 0 - 9).

isalpha
Alfabetico (A - Z o a - z).Alphabetic (A - Z or a - z).

__isascii
Carattere ASCII (0x00 - 0x7F).ASCII character (0x00 - 0x7F).

isblank
Tabulazione orizzontale o spazio (0x09 o 0x20).Horizontal tab or space character (0x09 or 0x20).

iscntrl
Carattere di controllo (0x00-0x1F o 0x7F).Control character (0x00 - 0x1F or 0x7F).

__iscsym
Lettera, carattere di sottolineatura o cifra.Letter, underscore, or digit.

__iscsymf
Lettera o carattere di sottolineatura.Letter or underscore.

isdigitisdigit
Cifra decimale (0 - 9).Decimal digit (0 - 9).

isgraph
Carattere stampabile, eccetto lo spazio ( ).Printable character except space ( ).

islower
Lettera minuscola (a - z).Lowercase letter (a - z).

isprint
Caratteri stampabili, incluso lo spazio (0x20 - 0x7E).Printable character including space (0x20 - 0x7E).

ispunct
Carattere di punteggiatura.Punctuation character.

isspace
Spazio vuoto (0x09 - 0x0D o 0x20).White-space character (0x09 - 0x0D or 0x20).

isupper
Lettera maiuscola (A - Z).Uppercase letter (A - Z).

isxdigit
Cifra esadecimale (A - F, a - f o 0 - 9).Hexadecimal digit (A - F, a - f, or 0 - 9).

Per le routine isw, il risultato del test per la condizione specifica è indipendente dalle impostazioni locali.For the isw routines, the result of the test for the specified condition is independent of locale. Le condizioni di test per le funzioni isw sono le seguenti:The test conditions for the isw functions are as follows:

iswalnum
iswalpha o iswdigit.iswalpha or iswdigit.

iswalpha
Qualsiasi carattere wide di un set definito a livello di implementazione per il quale nessuna delle funzioni iswcntrl, iswdigit, iswpunct, o iswspace è diversa da zero.Any wide character that is one of an implementation-defined set for which none of iswcntrl, iswdigit, iswpunct, or iswspace is nonzero. iswalpha restituisce un valore diverso da zero solo per i caratteri wide per i quali iswupper o iswlower è diversa da zero.iswalpha returns nonzero only for wide characters for which iswupper or iswlower is nonzero.

iswascii
Rappresentazione di caratteri wide in caratteri ASCII (0x0000 - 0x007F).Wide-character representation of ASCII character (0x0000 - 0x007F).

iswblank
Carattere wide che corrisponde allo spazio standard o è parte di un set definito a livello di implementazione di caratteri wide per il quale la funzione iswalnum è falsa.Wide character that corresponds to the standard space character or is one of an implementation-defined set of wide characters for which iswalnum is false. I caratteri vuoti standard sono spazio (L' ') e tabulazione orizzontale (L'\t').Standard blank characters are space (L' ') and horizontal tab (L'\t').

iswcntrl
Carattere di controllo wide.Control wide character.

__iswcsym__iswcsym
Qualsiasi carattere wide per il quale la funzione isalnum è vera, o il carattere "".Any wide character for which isalnum is true, or the '' character.

__iswcsymf__iswcsymf
Qualsiasi carattere wide per il quale iswalpha è vera, o il carattere "".Any wide character for which iswalpha is true, or the '' character.

iswctype
Il carattere ha una proprietà specificata dall'argomento desc.Character has property specified by the desc argument. Per ogni valore valido dell'argomento desc della funzione iswctype, esiste un'equivalente routine di classificazione a caratteri wide, come illustrato nella tabella seguente:For each valid value of the desc argument of iswctype, there is an equivalent wide-character classification routine, as shown in the following table:

Equivalenza di iswctype ( Equivalence of iswctype(
c, desc ) ad altre routine di test iswc, desc ) to Other isw Testing Routines

Valore dell'argomento descValue of desc argument Equivalente di iswctype( c, desc)iswctype( c, desc ) equivalent
_ALPHA_ALPHA iswalpha( c )iswalpha( c )
_ALPHA | _DIGIT_ALPHA | _DIGIT iswalnum( c )iswalnum( c )
_BLANK_BLANK iswblank( c )iswblank( c )
_CONTROL_CONTROL iswcntrl( c )iswcntrl( c )
_DIGIT_DIGIT iswdigit( c )iswdigit( c )
_ALPHA | _DIGIT | _PUNCT_ALPHA | _DIGIT | _PUNCT iswgraph( c )iswgraph( c )
_LOWER_LOWER iswlower( c )iswlower( c )
_ALPHA | _BLANK | _DIGIT | _PUNCT_ALPHA | _BLANK | _DIGIT | _PUNCT iswprint( c )iswprint( c )
_PUNCT_PUNCT iswpunct( c )iswpunct( c )
_BLANK_BLANK iswblank( c )iswblank( c )
_SPACE_SPACE iswspace( c )iswspace( c )
_UPPER_UPPER iswupper( c )iswupper( c )
_HEX_HEX iswxdigit( c )iswxdigit( c )

iswdigit
Carattere wide corrispondente a una cifra decimale.Wide character corresponding to a decimal-digit character.

iswgraph
Carattere wide stampabile, escluso il carattere wide dello spazio (L ').Printable wide character except space wide character (L' ').

iswlower
Lettera minuscola o una parte di un set di caratteri wide definito dall'implementazione per il quale nessuna delle funzioni iswcntrl, iswdigit, iswpunct, o iswspace è diversa da zero.Lowercase letter, or one of implementation-defined set of wide characters for which none of iswcntrl, iswdigit, iswpunct, or iswspace is nonzero. iswlower restituisce un valore diverso da zero solo per i caratteri wide che corrispondono a lettere minuscole.iswlower returns nonzero only for wide characters that correspond to lowercase letters.

iswprint
Carattere wide stampabile, incluso il carattere wide dello spazio (L ').Printable wide character, including space wide character (L' ').

iswpunct
Carattere wide stampabile che non sia il carattere wide di spazio (L' ') né un carattere wide per il quale la funzione iswalnum sia diversa da zero.Printable wide character that is neither space wide character (L' ') nor wide character for which iswalnum is nonzero.

iswspace
Carattere wide che corrisponde allo spazio vuoto standard o è parte di un set definito a livello di implementazione di caratteri wide per il quale la funzione iswalnum è falsa.Wide character that corresponds to standard white-space character or is one of implementation-defined set of wide characters for which iswalnum is false. Gli spazi vuoti standard sono: spazio (L' '), modulo continuo (L'\f'), nuova riga (L'\n'), ritorno a capo (L'\r'), tabulazione orizzontale (L'\t') e tabulazione verticale (L'\v').Standard white-space characters are: space (L' '), formfeed (L'\f'), newline (L'\n'), carriage return (L'\r'), horizontal tab (L'\t'), and vertical tab (L'\v').

iswupper
Carattere wide maiuscolo o una parte di un set di caratteri wide definito a livello di implementazione per il quale nessuna delle funzioni iswcntrl, iswdigit, iswpunct, o iswspace è diversa da zero.Wide character that is uppercase or is one of an implementation-defined set of wide characters for which none of iswcntrl, iswdigit, iswpunct, or iswspace is nonzero. iswupper restituisce un valore diverso da zero solo per i caratteri wide che corrispondono a caratteri maiuscoli.iswupper returns nonzero only for wide characters that correspond to uppercase characters.

iswxdigit
Carattere wide che corrisponde a una cifra esadecimale.Wide character that corresponds to a hexadecimal-digit character.

EsempioExample

// 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" );  
   }  
}  

OutputOutput

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                              .  

Vedere ancheSee Also

Classificazione di caratteri Character Classification
Impostazioni locali Locale
setlocale, _wsetlocale setlocale, _wsetlocale
Interpretazione di sequenze di caratteri multibyte Interpretation of Multibyte-Character Sequences
Funzioni toto Functions