]> git.ipfire.org Git - thirdparty/man-pages.git/blame - man3/iswpunct.3
man*/: ffix (un-bracket tables)
[thirdparty/man-pages.git] / man3 / iswpunct.3
CommitLineData
a1eaacb1 1'\" t
fea681da
MK
2.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3.\"
e4a74ca8 4.\" SPDX-License-Identifier: GPL-2.0-or-later
fea681da
MK
5.\"
6.\" References consulted:
7.\" GNU glibc-2 source code and manual
8.\" Dinkumware C library reference http://www.dinkumware.com/
008f1ecc 9.\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
fea681da
MK
10.\" ISO/IEC 9899:1999
11.\"
4c1c5274 12.TH iswpunct 3 (date) "Linux man-pages (unreleased)"
fea681da
MK
13.SH NAME
14iswpunct \- test for punctuation or symbolic wide character
ac9fd3df
AC
15.SH LIBRARY
16Standard C library
8fc3b2cf 17.RI ( libc ", " \-lc )
fea681da
MK
18.SH SYNOPSIS
19.nf
20.B #include <wctype.h>
68e4db0a 21.PP
fea681da
MK
22.BI "int iswpunct(wint_t " wc );
23.fi
24.SH DESCRIPTION
60a90ecd
MK
25The
26.BR iswpunct ()
27function is the wide-character equivalent of the
28.BR ispunct (3)
29function.
35cfd378
MK
30It tests whether
31.I wc
32is a wide character
d0f17b57 33belonging to the wide-character class "punct".
fea681da 34.PP
d0f17b57
MK
35The wide-character class "punct" is a subclass of the wide-character class
36"graph", and therefore also a subclass of the wide-character class "print".
fea681da 37.PP
d0f17b57 38The wide-character class "punct" is disjoint from the wide-character class
fea681da
MK
39"alnum" and therefore also disjoint from its subclasses "alpha", "upper",
40"lower", "digit", "xdigit".
41.PP
d0f17b57
MK
42Being a subclass of the wide-character class "print",
43the wide-character class
44"punct" is disjoint from the wide-character class "cntrl".
fea681da 45.PP
d0f17b57
MK
46Being a subclass of the wide-character class "graph",
47the wide-character class
48"punct" is disjoint from the wide-character class "space" and its subclass
fea681da 49"blank".
47297adb 50.SH RETURN VALUE
60a90ecd
MK
51The
52.BR iswpunct ()
c7094399 53function returns nonzero
35cfd378
MK
54if
55.I wc
56is a wide-character
d0f17b57 57belonging to the wide-character class "punct".
2b9b829d 58Otherwise, it returns zero.
b2c5b0e9
PH
59.SH ATTRIBUTES
60For an explanation of the terms used in this section, see
61.BR attributes (7).
62.TS
63allbox;
c466875e 64lbx lb lb
b2c5b0e9
PH
65l l l.
66Interface Attribute Value
67T{
9e54434e
BR
68.na
69.nh
b2c5b0e9
PH
70.BR iswpunct ()
71T} Thread safety MT-Safe locale
72.TE
c466875e 73.sp 1
3113c7f3 74.SH STANDARDS
4131356c
AC
75C11, POSIX.1-2008.
76.SH HISTORY
77POSIX.1-2001, C99.
fea681da 78.SH NOTES
d9bfdb9c 79The behavior of
60a90ecd 80.BR iswpunct ()
1274071a
MK
81depends on the
82.B LC_CTYPE
83category of the
fea681da
MK
84current locale.
85.PP
86This function's name is a misnomer when dealing with Unicode characters,
d0f17b57 87because the wide-character class "punct" contains both punctuation characters
fea681da 88and symbol (math, currency, etc.) characters.
47297adb 89.SH SEE ALSO
e37e3282
MK
90.BR ispunct (3),
91.BR iswctype (3)