isprint, iswprint, _isprint_l, _iswprint_l

Determines whether an integer represents a printable character.

Syntax

int isprint(
   int c
);
int iswprint(
   wint_t c
);
int _isprint_l(
   int c,
   _locale_t locale
);
int _iswprint_l(
   wint_t c,
   _locale_t locale
);

Parameters

c
Integer to test.

locale
The locale to use.

Return value

Each of these routines returns nonzero if c is a particular representation of a printable character. isprint returns a nonzero value if c is a printable character (0x20 - 0x7E), including the space character. 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 doesn't satisfy the test condition.

The result of the test condition for these functions depends on the LC_CTYPE category setting of the locale. For more information, see setlocale, _wsetlocale. The versions of these functions that don't have the _l suffix use the current locale for any locale-dependent behavior; the versions that do have the _l suffix are identical except that they use the locale that's passed in instead. For more information, see Locale.

The behavior of isprint and _isprint_l is undefined if c isn't EOF or in the range 0 through 0xFF, inclusive. When a debug CRT library is used and c isn't one of these values, the functions raise an assertion.

Generic-text routine mappings

Remarks

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

Requirements

For more compatibility information, see Compatibility.

See also

Character classification
Locale
is, isw routines