Debian Codegraph @

upstream/debian-unstable/man3/wctype.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 wctype 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 wctype \- wide-character classification
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 "wctype_t wctype(const char *" name );
18 .fi
19 .SH DESCRIPTION
20 The
21 .I wctype_t
22 type represents a property which a wide character may or
23 may not have.
24 In other words, it represents a class of wide characters.
25 This type's nature is implementation-dependent, but the special value
26 .I "(wctype_t) 0"
27 denotes an invalid property.
28 Nonzero
29 .I wctype_t
30 values
31 can be passed to the
32 .BR iswctype (3)
33 function
34 to actually test whether a given
35 wide character has the property.
36 .P
37 The
38 .BR wctype ()
39 function returns a property, given by its name.
40 The set of
41 valid names depends on the
42 .B LC_CTYPE
43 category of the current locale, but the
44 following names are valid in all locales.
45 .IP
46 .TS
47 L1 Lx.
48 "alnum" \- realizes the \f[B]isalnum\f[](3) classification function
49 "alpha" \- realizes the \f[B]isalpha\f[](3) classification function
50 "blank" \- realizes the \f[B]isblank\f[](3) classification function
51 "cntrl" \- realizes the \f[B]iscntrl\f[](3) classification function
52 "digit" \- realizes the \f[B]isdigit\f[](3) classification function
53 "graph" \- realizes the \f[B]isgraph\f[](3) classification function
54 "lower" \- realizes the \f[B]islower\f[](3) classification function
55 "print" \- realizes the \f[B]isprint\f[](3) classification function
56 "punct" \- realizes the \f[B]ispunct\f[](3) classification function
57 "space" \- realizes the \f[B]isspace\f[](3) classification function
58 "upper" \- realizes the \f[B]isupper\f[](3) classification function
59 "xdigit" \- realizes the \f[B]isxdigit\f[](3) classification function
60 .TE
61 .SH RETURN VALUE
62 The
63 .BR wctype ()
64 function returns a property descriptor
65 if the
66 .I name
67 is valid.
68 Otherwise, it returns
69 .IR "(wctype_t) 0" .
70 .SH ATTRIBUTES
71 For an explanation of the terms used in this section, see
72 .BR attributes (7).
73 .TS
74 allbox;
75 lbx lb lb
76 l l l.
77 Interface Attribute Value
78 T{
79 .na
80 .nh
81 .BR wctype ()
82 T} Thread safety MT-Safe locale
83 .TE
84 .SH STANDARDS
85 C11, POSIX.1-2008.
86 .SH HISTORY
87 POSIX.1-2001, C99.
88 .SH NOTES
89 The behavior of
90 .BR wctype ()
91 depends on the
92 .B LC_CTYPE
93 category of the
94 current locale.
95 .SH SEE ALSO
96 .BR iswctype (3)