Character Manipulation Function

int ispunct(int c);

int iswpunct(wint_t c);

int _ismbcpunct(unsigned int c);

int _istpunct(_TINT c);

Internationalization (I18n) Function Overview

The function ispunct tests for an punctuation character, using the LC_CTYPE category setting of the current locale.

iswpunct is the wide character equivalent of ispunct, testing the wide character c.

Supported only on Windows platforms, _ismbcpunct is the multibyte equivalent, treating c as a multibyte character and calling _ismbbpunct.

_istpunct is the Windows-only Generic version of the function; with the _MBCS or _UNICODE compiler flags determining its mapping to either _ismbcpunct or iswpunct.

I18n Issues

Use the appropriate version of the function as required for internationalization support, noting the following:

On ANSI platforms, there is no multibyte version of ispunct. Instead, convert the character c to a wide character and call iswpunct.

Prior to calling iswpunct on ANSI platforms, ensure that the locale is set correctly, since the result of the test condition depends on the locale's LC_CTYPE category setting. On Windows platforms, the iswpunct test is independent of locale.

The _ismbcpunct function depends on the multibyte code page in effect. By default, the multibyte code page is set to the system-default ANSI code page obtained from the operating system at program startup. Use _getmbcp and _setmbcp to query or change the current multibyte code page, respectively.

Recommended Replacements*

ANSI UTF-8	convert and call iswpunct
ANSI UTF-16	iswpunct
Microsoft Windows MBCS	_ismbcpunct
Microsoft Windows Unicode	iswpunct
Microsoft Windows Generic	_istpunct

Character Manipulation Functions