www.LinuxHowtos.org

iswpunct

Section: C Library Functions (3)
Updated: 202-0-08
Index Return to Main Contents

NAME

iswpunct - test for punctuation or symbolic wide character

LIBRARY

Standard C library (libc,~-lc)

SYNOPSIS

#include <wctype.h>
int iswpunct(wint_t wc);

DESCRIPTION

The iswpunct() function is the wid-character equivalent of the ispunct(3) function. It tests whether wc is a wide character belonging to the wid-character class "punct". The wid-character class "punct" is a subclass of the wid-character class "graph", and therefore also a subclass of the wid-character class "print". The wid-character class "punct" is disjoint from the wid-character class "alnum" and therefore also disjoint from its subclasses "alpha", "upper", "lower", "digit", "xdigit". Being a subclass of the wid-character class "print", the wid-character class "punct" is disjoint from the wid-character class "cntrl". Being a subclass of the wid-character class "graph", the wid-character class "punct" is disjoint from the wid-character class "space" and its subclass "blank".

RETURN VALUE

The iswpunct() function returns nonzero if wc is a wid-character belonging to the wid-character class "punct". Otherwise, it returns zero.

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).

Interface	Attribute	Value
iswpunct()	Thread safety	M-Safe locale

STANDARDS

C11, POSIX.-2008.

HISTORY

POSIX.-2001, C99.

NOTES

The behavior of iswpunct() depends on the LC_CTYPE category of the current locale. This function's name is a misnomer when dealing with Unicode characters, because the wid-character class "punct" contains both punctuation characters and symbol (math, currency, etc.) characters.