iscsym, iscsymf, __iscsym, __iswcsym, __iscsymf, __iswcsymf, _iscsym_l, _iswcsym_l, _iscsymf_l, _iswcsymf_l

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at iscsym, iscsymf, __iscsym, __iswcsym, __iscsymf, __iswcsymf, _iscsym_l, _iswcsym_l, _iscsymf_l, _iswcsymf_l.

Determine if an integer represents a character that may be used in an identifier.

Syntax

int __iscsym(   
   int c   
);  
int __iswcsym(   
   wint_t c   
);  
int __iscsymf(   
   int c   
);  
int __iswcsymf(   
   wint_t c   
);  
int _iscsym_l(   
   int c,  
   _locale_t locale  
);  
int _iswcsym_l(   
   wint_t c,  
   _locale_t locale  
);  
int _iscsymf_l(   
   int c,  
   _locale_t locale  
);  
int _iswcsymf_l(   
   wint_t c,  
   _locale_t locale  
);  
#define iscsym __iscsym  
#define iscsymf __iscsymf  

Parameters

c
Integer to test. c should be in the range of 0-255 for the narrow character version of the function.

locale
The locale to use.

Return Value

Both __iscsym and __iswcsym return a nonzero value if c is a letter, underscore, or digit. Both __iscsymf and __iswcsymf return a nonzero value if c is a letter or an underscore. Each of these routines returns 0 if c does not satisfy the test condition. The versions of these functions with the _l suffix are identical except that they use the locale passed in instead of the current locale for their locale-dependent behavior. For more information, see Locale.

Remarks

These routines are defined as macros unless the preprocessor macro _CTYPE_DISABLE_MACROS is defined. When you use the macro versions of these routines, the arguments can be evaluated more than once. Be careful when you use expressions that have side effects within the argument list.

For backward compatibility, iscsym and iscsymf are defined as macros only when __STDC__ is not defined or is defined as 0; otherwise they are undefined.

Requirements

The iscsym, iscsymf, __iscsym, __iswcsym, __iscsymf, __iswcsymf, _iscsym_l, _iswcsym_l, _iscsymf_l, and _iswcsymf_l routines are Microsoft specific. For additional compatibility information, see Compatibility in the Introduction.

See Also

Character Classification
Locale
is, isw Routines