iswpunct(3)

1iswpunct(3)                Library Functions Manual                iswpunct(3)
2
3
4

NAME

6       iswpunct - test for punctuation or symbolic wide character
7

LIBRARY

9       Standard C library (libc, -lc)
10

SYNOPSIS

12       #include <wctype.h>
13
14       int iswpunct(wint_t wc);
15

DESCRIPTION

17       The  iswpunct()  function  is  the wide-character equivalent of the is‐
18       punct(3) function.  It tests whether wc is a wide  character  belonging
19       to the wide-character class "punct".
20
21       The  wide-character  class  "punct" is a subclass of the wide-character
22       class "graph", and therefore also  a  subclass  of  the  wide-character
23       class "print".
24
25       The  wide-character  class  "punct" is disjoint from the wide-character
26       class "alnum" and therefore also disjoint from its subclasses  "alpha",
27       "upper", "lower", "digit", "xdigit".
28
29       Being  a subclass of the wide-character class "print", the wide-charac‐
30       ter class "punct" is disjoint from the wide-character class "cntrl".
31
32       Being a subclass of the wide-character class "graph", the  wide-charac‐
33       ter class "punct" is disjoint from the wide-character class "space" and
34       its subclass "blank".
35

RETURN VALUE

37       The iswpunct() function returns nonzero if wc is a  wide-character  be‐
38       longing  to  the  wide-character  class "punct".  Otherwise, it returns
39       zero.
40

ATTRIBUTES

42       For an  explanation  of  the  terms  used  in  this  section,  see  at‐
43       tributes(7).
44
45       ┌─────────────────────────────────────┬───────────────┬────────────────┐
46       │Interface                            │ Attribute     │ Value          │
47       ├─────────────────────────────────────┼───────────────┼────────────────┤
48       │iswpunct()                           │ Thread safety │ MT-Safe locale │
49       └─────────────────────────────────────┴───────────────┴────────────────┘
50

STANDARDS

52       C11, POSIX.1-2008.
53

HISTORY

55       POSIX.1-2001, C99.
56

NOTES

58       The behavior of iswpunct() depends on the LC_CTYPE category of the cur‐
59       rent locale.
60
61       This function's name is a misnomer when dealing  with  Unicode  charac‐
62       ters,  because  the wide-character class "punct" contains both punctua‐
63       tion characters and symbol (math, currency, etc.) characters.
64