ispunct, iswpunct, _ispunct_l, _iswpunct_l

Determines whether an integer represents a punctuation character.

Syntax

int ispunct(
   int c
);
int iswpunct(
   wint_t c
);
int _ispunct_l(
   int c,
   _locale_t locale
);
int _iswpunct_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 punctuation character. ispunct returns a nonzero value for any printable character that isn't a space character or a character for which isalnum is nonzero. iswpunct returns a nonzero value for any printable wide character that isn't the space wide character or a wide character for which iswalnum is nonzero. Each of these routines returns 0 if c doesn't satisfy the test condition.

The result of the test condition for the ispunct function 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 ispunct and _ispunct_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