]>
Commit | Line | Data |
---|---|---|
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/ | |
11 | .\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html | |
12 | .\" ISO/IEC 9899:1999 | |
13 | .\" | |
14 | .TH WCTRANS 3 1999-07-25 "GNU" "Linux Programmer's Manual" | |
15 | .SH NAME | |
16 | wctrans \- wide character translation mapping | |
17 | .SH SYNOPSIS | |
18 | .nf | |
19 | .B #include <wctype.h> | |
20 | .sp | |
21 | .BI "wctrans_t wctrans(const char *" name ); | |
22 | .fi | |
23 | .SH DESCRIPTION | |
c13182ef MK |
24 | The \fBwctrans_t\fP type represents a mapping |
25 | which can map a wide character to | |
26 | another wide character. | |
27 | Its nature is implementation dependent, but the special | |
28 | value \fI(wctrans_t)\ 0\fP denotes an invalid mapping. | |
29 | Nonzero \fBwctrans_t\fP | |
3382bd94 | 30 | values can be passed to the \fBtowctrans\fP() function to actually perform |
fea681da MK |
31 | the wide character mapping. |
32 | .PP | |
c13182ef MK |
33 | The \fBwctrans\fP() function returns a mapping, given by its name. |
34 | The set of | |
fea681da MK |
35 | valid names depends on the LC_CTYPE category of the current locale, but the |
36 | following names are valid in all locales. | |
37 | .nf | |
2bc2f479 MK |
38 | "tolower" \- realizes the \fBtolower\fP(3) mapping |
39 | "toupper" \- realizes the \fBtoupper\fP(3) mapping | |
fea681da MK |
40 | .fi |
41 | .SH "RETURN VALUE" | |
e511ffb6 | 42 | The \fBwctrans\fP() function returns a mapping descriptor if the \fIname\fP |
c13182ef MK |
43 | is valid. |
44 | Otherwise it returns \fI(wctrans_t)0\fP. | |
fea681da | 45 | .SH "CONFORMING TO" |
68e1685c | 46 | C99. |
fea681da | 47 | .SH "SEE ALSO" |
d8495818 | 48 | .BR towctrans (3) |
fea681da | 49 | .SH NOTES |
e511ffb6 | 50 | The behaviour of \fBwctrans\fP() depends on the LC_CTYPE category of the |
fea681da | 51 | current locale. |