Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

iscntrl, iswcntrl

int iscntrl( 
   int c 
);
int iswcntrl( 
   wint_t c 
);

Each of these routines returns nonzero if c is a particular representation of a control character.

Parameter

c
Integer to test

Return Value

iscntrl returns a non-zero value if c is a control character (0x00 – 0x1F or 0x7F). iswcntrl returns a non-zero value if c is a control wide character. Each of these routines returns 0 if c does not satisfy the test condition.

The result of the test condition for the iscntrl function depends on the LC_CTYPE category setting of the current locale; see setlocale for more information. For iswcntrl, the result of the test condition is independent of locale.

When used with a debug CRT library, iscntrl will display a CRT assert if passed a parameter that isn't EOF or in the range of 0 through 0xFF. When used with a debug CRT library, iscntrl will use the parameter as an index into an array, with undefined results if the parameter isn't EOF or in the range of 0 through 0xFF.

Generic-Text Routine Mappings

TCHAR.H routine _UNICODE & _MBCS not defined _MBCS defined _UNICODE defined
_istcntrl iscntrl iscntrl iswcntrl

Requirements

Routine Required header Compatibility
iscntrl <ctype.h> ANSI, Win 98, Win Me, Win NT, Win 2000, Win XP
iswcntrl <ctype.h> or <wchar.h> ANSI, Win 98, Win Me, Win NT, Win 2000, Win XP

For additional compatibility information, see Compatibility in the Introduction.

Libraries

All versions of the C run-time libraries.

See Also

Character Classification Routines | Locale Routines | is, isw Function Overview | Run-Time Routines and .NET Framework Equivalents

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.