isprint, iswprint
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. ArchiveDisclaimer

isprint, iswprint

int isprint(
   int c 
);
int iswprint(
   wint_t c 
);

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

Parameter

c
Integer to test.

Return Value

isprint returns a nonzero value if c is a printable character, including the space character (0x20 – 0x7E). iswprint returns a nonzero value if c is a printable wide character, including the space wide character. Each of these routines returns 0 if c does not satisfy the test condition.

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

When used with a debug CRT library, isprint 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, isprint 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
_istprint isprint _ismbcprint iswprint

Requirements

Routine Required header Compatibility
isprint <ctype.h> ANSI, Win 98, Win Me, Win NT, Win 2000, Win XP
iswprint <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

Show:
© 2016 Microsoft