Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
div
eof
Expand Minimize
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.

__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.

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
);

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.

__iscsym returns a nonzero value if c is a letter, underscore, or digit. __iscsymf returns 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. Both of these routines are macros, so be careful using expressions with side effects within the argument list; the arguments will be evaluated more than once.

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.

In Visual C++ 2005, the wide character versions of these macros are available.

The following table shows the equivalent expressions for each of these macros:

Macro

Equivalent

__iscsym(c)

(isalnum(c) || ((c) == '_'))

__iswcsym(c)

(iswalnum(c) || ((c) == '_'))

__iscsymf(c)

(isalpha(c) || ((c) == '_'))

__iswcsymf(c)

(iswalpha(c) || ((c) == '_'))

Routine

Required header

__iscsym

<ctype.h>

__iswcsym

<ctype.h>

__iscsymf

<ctype.h>

__iswcsymf

<ctype.h>

_iscsym_l

<ctype.h>

_iswcsym_l

<ctype.h>

_iscsymf_l

<ctype.h>

_iswcsymf_l

<ctype.h>

For additional compatibility information, see Compatibility in the Introduction.

Community Additions

ADD
Show:
© 2015 Microsoft