summaryrefslogtreecommitdiffstats
path: root/man3/towctrans.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/towctrans.3')
-rw-r--r--man3/towctrans.341
1 files changed, 41 insertions, 0 deletions
diff --git a/man3/towctrans.3 b/man3/towctrans.3
new file mode 100644
index 000000000..1634a7b5d
--- /dev/null
+++ b/man3/towctrans.3
@@ -0,0 +1,41 @@
+.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
+.\"
+.\" This is free documentation; you can redistribute it and/or
+.\" modify it under the terms of the GNU General Public License as
+.\" published by the Free Software Foundation; either version 2 of
+.\" the License, or (at your option) any later version.
+.\"
+.\" References consulted:
+.\" GNU glibc-2 source code and manual
+.\" Dinkumware C library reference http://www.dinkumware.com/
+.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
+.\" ISO/IEC 9899:1999
+.\"
+.TH TOWCTRANS 3 1999-07-25 "GNU" "Linux Programmer's Manual"
+.SH NAME
+towctrans \- wide-character transliteration
+.SH SYNOPSIS
+.nf
+.B #include <wctype.h>
+.sp
+.BI "wint_t towctrans(wint_t " wc ", wctrans_t " desc );
+.fi
+.SH DESCRIPTION
+If \fIwc\fP is a wide character, the \fBtowctrans\fP function translates it
+according to the transliteration descriptor \fIdesc\fP. If \fIwc\fP is WEOF,
+WEOF is returned.
+.PP
+\fIdesc\fP must be a transliteration descriptor returned by the \fBwctrans\fP
+function.
+.SH "RETURN VALUE"
+The \fBtowctrans\fP function returns the translated wide character, or WEOF if
+\fIwc\fP is WEOF.
+.SH "CONFORMING TO"
+ISO/ANSI C, UNIX98
+.SH "SEE ALSO"
+.BR towlower (3),
+.BR towupper (3),
+.BR wctrans (3)
+.SH NOTES
+The behaviour of \fBtowctrans\fP depends on the LC_CTYPE category of the
+current locale.