'\" te
.\"  Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved
.TH towctrans 3C "14 Aug 2002" "SunOS 5.11" "Standard C Library Functions"
.SH NAME
towctrans \- wide-character mapping
.SH SYNOPSIS
.LP
.nf
#include <wctype.h>

\fBwint_t\fR \fBtowctrans\fR(\fBwint_t\fR \fIwc\fR, \fBwctrans_t\fR \fIdesc\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The \fBtowctrans()\fR function maps the wide character \fIwc\fR using the mapping described by \fIdesc\fR. The current setting of the \fBLC_CTYPE\fR category shall be the same as during the call to \fBwctrans()\fR that returned the value \fIdesc\fR.
.sp
.LP
The function call \fBtowctrans(\fR\fIwc\fR\fB\fR\fB,\fR \fBwctrans("tolower"))\fR behaves the same as \fBtowlower(\fR\fIwc\fR\fB\fR\fB)\fR.
.sp
.LP
The function call \fBtowctrans(\fR\fIwc\fR\fB\fR\fB,\fR \fBwctrans("toupper"))\fR behaves the same as \fBtowupper(\fR\fIwc\fR\fB\fR\fB)\fR.
.SH RETURN VALUES
.sp
.LP
The \fBtowctrans()\fR function returns the mapped value of \fIwc\fR, using the mapping described by \fIdesc\fR; otherwise, it returns \fIwc\fR unchanged.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
CSIEnabled
_
Interface StabilityCommitted
_
MT-LevelMT-Safe with exceptions
_
StandardSee \fBstandards\fR(5).
.TE

.SH SEE ALSO
.sp
.LP
\fBsetlocale\fR(3C), \fBwctrans\fR(3C), \fBattributes\fR(5), \fBstandards\fR(5)