Debian Codegraph @

upstream/debian-unstable/man3/towctrans.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 towctrans 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 towctrans \- wide-character transliteration
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 "wint_t towctrans(wint_t " wc ", wctrans_t " desc );
18 .fi
19 .SH DESCRIPTION
20 If
21 .I wc
22 is a wide character, then the
23 .BR towctrans ()
24 function
25 translates it according to the transliteration descriptor
26 .IR desc .
27 If
28 .I wc
29 is
30 .BR WEOF ,
31 .B WEOF
32 is returned.
33 .P
34 .I desc
35 must be a transliteration descriptor returned by
36 the
37 .BR wctrans (3)
38 function.
39 .SH RETURN VALUE
40 The
41 .BR towctrans ()
42 function returns the translated wide character,
43 or
44 .B WEOF
45 if
46 .I wc
47 is
48 .BR WEOF .
49 .SH ATTRIBUTES
50 For an explanation of the terms used in this section, see
51 .BR attributes (7).
52 .TS
53 allbox;
54 lbx lb lb
55 l l l.
56 Interface Attribute Value
57 T{
58 .na
59 .nh
60 .BR towctrans ()
61 T} Thread safety MT-Safe
62 .TE
63 .SH STANDARDS
64 C11, POSIX.1-2008.
65 .SH HISTORY
66 POSIX.1-2001, C99.
67 .SH NOTES
68 The behavior of
69 .BR towctrans ()
70 depends on the
71 .B LC_CTYPE
72 category of the
73 current locale.
74 .SH SEE ALSO
75 .BR towlower (3),
76 .BR towupper (3),
77 .BR wctrans (3)