Debian Codegraph @

upstream/debian-unstable/man3/iswalnum.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 iswalnum 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 iswalnum \- test for alphanumeric 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 iswalnum(wint_t " wc );
18 .fi
19 .SH DESCRIPTION
20 The
21 .BR iswalnum ()
22 function is the wide-character equivalent of the
23 .BR isalnum (3)
24 function.
25 It tests whether
26 .I wc
27 is a wide character
28 belonging to the wide-character class "alnum".
29 .P
30 The wide-character class "alnum" is a subclass of the wide-character class
31 "graph", and therefore also a subclass of the wide-character class "print".
32 .P
33 Being a subclass of the wide-character class "print",
34 the wide-character class
35 "alnum" is disjoint from the wide-character class "cntrl".
36 .P
37 Being a subclass of the wide-character class "graph",
38 the wide-character class "alnum" is disjoint from
39 the wide-character class "space" and its subclass "blank".
40 .P
41 The wide-character class "alnum" is disjoint from the wide-character class
42 "punct".
43 .P
44 The wide-character class "alnum" is the union of the wide-character classes
45 "alpha" and "digit".
46 As such, it also contains the wide-character class
47 "xdigit".
48 .P
49 The wide-character class "alnum"
50 always contains at least the letters
51 \[aq]A\[aq] to \[aq]Z\[aq],
52 \[aq]a\[aq] to \[aq]z\[aq],
53 and the digits \[aq]0\[aq] to \[aq]9\[aq].
54 .SH RETURN VALUE
55 The
56 .BR iswalnum ()
57 function returns nonzero
58 if
59 .I wc
60 is a wide character
61 belonging to the wide-character class "alnum".
62 Otherwise, it returns zero.
63 .SH ATTRIBUTES
64 For an explanation of the terms used in this section, see
65 .BR attributes (7).
66 .TS
67 allbox;
68 lbx lb lb
69 l l l.
70 Interface Attribute Value
71 T{
72 .na
73 .nh
74 .BR iswalnum ()
75 T} Thread safety MT-Safe locale
76 .TE
77 .SH STANDARDS
78 C11, POSIX.1-2008.
79 .SH HISTORY
80 POSIX.1-2001, C99.
81 .SH NOTES
82 The behavior of
83 .BR iswalnum ()
84 depends on the
85 .B LC_CTYPE
86 category of the
87 current locale.
88 .SH SEE ALSO
89 .BR isalnum (3),
90 .BR iswctype (3)