Debian Codegraph @

upstream/debian-unstable/man3/iswpunct.3

raw
1 '\" t
2 .\" Copyright, Bruno Haible <[email protected]>
3 .\" Copyright, the authors of the Linux man-pages project
4 .\"
5 .\" SPDX-License-Identifier: GPL-2.0-or-later
6 .\"
7 .TH iswpunct 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 iswpunct \- test for punctuation or symbolic wide character
10 .SH LIBRARY
11 Standard C library
12 .RI ( libc ,\~ \-lc )
13 .SH SYNOPSIS
14 .nf
15 .B #include <wctype.h>
16 .P
17 .BI "int iswpunct(wint_t " wc );
18 .fi
19 .SH DESCRIPTION
20 The
21 .BR iswpunct ()
22 function is the wide-character equivalent of the
23 .BR ispunct (3)
24 function.
25 It tests whether
26 .I wc
27 is a wide character
28 belonging to the wide-character class "punct".
29 .P
30 The wide-character class "punct" is a subclass of the wide-character class
31 "graph", and therefore also a subclass of the wide-character class "print".
32 .P
33 The wide-character class "punct" is disjoint from the wide-character class
34 "alnum" and therefore also disjoint from its subclasses "alpha", "upper",
35 "lower", "digit", "xdigit".
36 .P
37 Being a subclass of the wide-character class "print",
38 the wide-character class
39 "punct" is disjoint from the wide-character class "cntrl".
40 .P
41 Being a subclass of the wide-character class "graph",
42 the wide-character class
43 "punct" is disjoint from the wide-character class "space" and its subclass
44 "blank".
45 .SH RETURN VALUE
46 The
47 .BR iswpunct ()
48 function returns nonzero
49 if
50 .I wc
51 is a wide-character
52 belonging to the wide-character class "punct".
53 Otherwise, it returns zero.
54 .SH ATTRIBUTES
55 For an explanation of the terms used in this section, see
56 .BR attributes (7).
57 .TS
58 allbox;
59 lbx lb lb
60 l l l.
61 Interface Attribute Value
62 T{
63 .na
64 .nh
65 .BR iswpunct ()
66 T} Thread safety MT-Safe locale
67 .TE
68 .SH STANDARDS
69 C11, POSIX.1-2008.
70 .SH HISTORY
71 POSIX.1-2001, C99.
72 .SH NOTES
73 The behavior of
74 .BR iswpunct ()
75 depends on the
76 .B LC_CTYPE
77 category of the
78 current locale.
79 .P
80 This function's name is a misnomer when dealing with Unicode characters,
81 because the wide-character class "punct" contains both punctuation characters
82 and symbol (math, currency, etc.) characters.
83 .SH SEE ALSO
84 .BR ispunct (3),
85 .BR iswctype (3)