]> git.ipfire.org Git - thirdparty/man-pages.git/blame - man3/iswalnum.3
Many pages: Use correct letter case in page titles (TH)
[thirdparty/man-pages.git] / man3 / iswalnum.3
CommitLineData
fea681da
MK
1.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
2.\"
e4a74ca8 3.\" SPDX-License-Identifier: GPL-2.0-or-later
fea681da
MK
4.\"
5.\" References consulted:
6.\" GNU glibc-2 source code and manual
7.\" Dinkumware C library reference http://www.dinkumware.com/
008f1ecc 8.\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
fea681da
MK
9.\" ISO/IEC 9899:1999
10.\"
4c1c5274 11.TH iswalnum 3 (date) "Linux man-pages (unreleased)"
fea681da
MK
12.SH NAME
13iswalnum \- test for alphanumeric wide character
4508f8a0
AC
14.SH LIBRARY
15Standard C library
8fc3b2cf 16.RI ( libc ", " \-lc )
fea681da
MK
17.SH SYNOPSIS
18.nf
19.B #include <wctype.h>
68e4db0a 20.PP
fea681da
MK
21.BI "int iswalnum(wint_t " wc );
22.fi
23.SH DESCRIPTION
60a90ecd
MK
24The
25.BR iswalnum ()
26function is the wide-character equivalent of the
3a72373c 27.BR isalnum (3)
60a90ecd 28function.
35cfd378
MK
29It tests whether
30.I wc
31is a wide character
d0f17b57 32belonging to the wide-character class "alnum".
fea681da 33.PP
d0f17b57
MK
34The wide-character class "alnum" is a subclass of the wide-character class
35"graph", and therefore also a subclass of the wide-character class "print".
fea681da 36.PP
d0f17b57
MK
37Being a subclass of the wide-character class "print",
38the wide-character class
39"alnum" is disjoint from the wide-character class "cntrl".
fea681da 40.PP
d0f17b57
MK
41Being a subclass of the wide-character class "graph",
42the wide-character class "alnum" is disjoint from
43the wide-character class "space" and its subclass "blank".
fea681da 44.PP
d0f17b57 45The wide-character class "alnum" is disjoint from the wide-character class
fea681da
MK
46"punct".
47.PP
d0f17b57 48The wide-character class "alnum" is the union of the wide-character classes
c13182ef 49"alpha" and "digit".
d0f17b57 50As such, it also contains the wide-character class
fea681da
MK
51"xdigit".
52.PP
f81fb444
MK
53The wide-character class "alnum" always contains at least the letters \(aqA\(aq
54to \(aqZ\(aq, \(aqa\(aq to \(aqz\(aq and the digits \(aq0\(aq to \(aq9\(aq.
47297adb 55.SH RETURN VALUE
60a90ecd
MK
56The
57.BR iswalnum ()
c7094399 58function returns nonzero
35cfd378
MK
59if
60.I wc
61is a wide character
d0f17b57 62belonging to the wide-character class "alnum".
2b9b829d 63Otherwise, it returns zero.
0c3ad9ea 64.SH ATTRIBUTES
12029c3d
MK
65For an explanation of the terms used in this section, see
66.BR attributes (7).
c466875e
MK
67.ad l
68.nh
12029c3d
MK
69.TS
70allbox;
c466875e 71lbx lb lb
12029c3d
MK
72l l l.
73Interface Attribute Value
74T{
0c3ad9ea 75.BR iswalnum ()
12029c3d
MK
76T} Thread safety MT-Safe locale
77.TE
c466875e
MK
78.hy
79.ad
80.sp 1
3113c7f3 81.SH STANDARDS
c9333f90 82POSIX.1-2001, POSIX.1-2008, C99.
fea681da 83.SH NOTES
d9bfdb9c 84The behavior of
60a90ecd 85.BR iswalnum ()
1274071a
MK
86depends on the
87.B LC_CTYPE
88category of the
fea681da 89current locale.
47297adb 90.SH SEE ALSO
e37e3282
MK
91.BR isalnum (3),
92.BR iswctype (3)