Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

ispunct, iswpunct

int ispunct(
   int c 
);
int iswpunct(
   wint_t c 
);

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

Parameter

c
Integer to test.

Return Value

ispunct returns a non-zero value for any printable character that is not a space character or a character for which isalnum is nonzero. iswpunct returns a non-zero value for any printable wide character that is neither the space wide character nor a wide character for which iswalnum is nonzero. Each of these routines returns 0 if c does not satisfy the test condition.

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

When used with a debug CRT library, ispunct 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, ispunct 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
_istpunct ispunct _ismbcpunct iswpunct

Requirements

Routine Required header Compatibility
ispunct <ctype.h> ANSI, Win 98, Win Me, Win NT, Win 2000, Win XP
iswpunct <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:
© 2015 Microsoft