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

iscntrl, iswcntrl, _iscntrl_l, _iswcntrl_l 

Determine if an integer represents a control character.


int iscntrl( 
   int c 
);
int iswcntrl( 
   wint_t c 
);
int _iscntrl_l( 
   int c,
   _locale_t locale
);
int _iswcntrl_l( 
   wint_t c,
   _locale_t locale
);

Parameters

c

Integer to test

locale

The locale to use.

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

When used with a debug CRT library, iscntrl will display a CRT assert if passed a parameter that is not 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 is not EOF or in the range of 0 through 0xFF.

The versions of these functions with the _l suffix are identical except that they use the locale parameter passed in instead of the current locale.

Generic-Text Routine Mappings
TCHAR.H routine _UNICODE & _MBCS not defined _MBCS defined _UNICODE defined

_istcntrl

iscntrl

iscntrl

iswcntrl

_istcntrl_l

_iscntrl_l

_iscntrl_l

_iswcntrl_l

Routine Required header Compatibility

iscntrl

<ctype.h>

ANSI, Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003

iswcntrl

<ctype.h> or <wchar.h>

ANSI, Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003

_iscntrl_l

<ctype.h>

Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003

_iswcntrl_l

<ctype.h> or <wchar.h>

Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003

For additional compatibility information, see Compatibility in the Introduction.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.