]> git.ipfire.org Git - thirdparty/man-pages.git/blame - man3/iswpunct.3
intro.1, time.1, accept.2, bind.2, connect.2, execve.2, flock.2, getdents.2, getprior...
[thirdparty/man-pages.git] / man3 / iswpunct.3
CommitLineData
fea681da
MK
1.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
2.\"
3.\" This is free documentation; you can redistribute it and/or
4.\" modify it under the terms of the GNU General Public License as
5.\" published by the Free Software Foundation; either version 2 of
6.\" the License, or (at your option) any later version.
7.\"
8.\" References consulted:
9.\" GNU glibc-2 source code and manual
10.\" Dinkumware C library reference http://www.dinkumware.com/
008f1ecc 11.\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
fea681da
MK
12.\" ISO/IEC 9899:1999
13.\"
14.TH ISWPUNCT 3 1999-07-25 "GNU" "Linux Programmer's Manual"
15.SH NAME
16iswpunct \- test for punctuation or symbolic wide character
17.SH SYNOPSIS
18.nf
19.B #include <wctype.h>
20.sp
21.BI "int iswpunct(wint_t " wc );
22.fi
23.SH DESCRIPTION
60a90ecd
MK
24The
25.BR iswpunct ()
26function is the wide-character equivalent of the
27.BR ispunct (3)
28function.
c13182ef 29It tests whether \fIwc\fP is a wide character
d0f17b57 30belonging to the wide-character class "punct".
fea681da 31.PP
d0f17b57
MK
32The wide-character class "punct" is a subclass of the wide-character class
33"graph", and therefore also a subclass of the wide-character class "print".
fea681da 34.PP
d0f17b57 35The wide-character class "punct" is disjoint from the wide-character class
fea681da
MK
36"alnum" and therefore also disjoint from its subclasses "alpha", "upper",
37"lower", "digit", "xdigit".
38.PP
d0f17b57
MK
39Being a subclass of the wide-character class "print",
40the wide-character class
41"punct" is disjoint from the wide-character class "cntrl".
fea681da 42.PP
d0f17b57
MK
43Being a subclass of the wide-character class "graph",
44the wide-character class
45"punct" is disjoint from the wide-character class "space" and its subclass
fea681da
MK
46"blank".
47.SH "RETURN VALUE"
60a90ecd
MK
48The
49.BR iswpunct ()
c7094399 50function returns nonzero
d0f17b57
MK
51if \fIwc\fP is a wide-character
52belonging to the wide-character class "punct".
c13182ef 53Otherwise it returns zero.
fea681da 54.SH "CONFORMING TO"
68e1685c 55C99.
fea681da 56.SH NOTES
d9bfdb9c 57The behavior of
60a90ecd 58.BR iswpunct ()
1274071a
MK
59depends on the
60.B LC_CTYPE
61category of the
fea681da
MK
62current locale.
63.PP
64This function's name is a misnomer when dealing with Unicode characters,
d0f17b57 65because the wide-character class "punct" contains both punctuation characters
fea681da 66and symbol (math, currency, etc.) characters.
e37e3282
MK
67.SH "SEE ALSO"
68.BR ispunct (3),
69.BR iswctype (3)