'\" te
.\"  Copyright (c) 2002, Sun Microsystems, Inc.  All Rights Reserved
.TH towlower 3C "14 Aug 2002" "SunOS 5.11" "Standard C Library Functions"
.SH NAME
towlower \- transliterate upper-case wide-character code to lower-case
.SH SYNOPSIS
.LP
.nf
#include <wchar.h> 

\fBwint_t\fR \fBtowlower\fR(\fBwint_t\fR \fIwc\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The \fBtowlower()\fR function has as a domain a type \fBwint_t\fR, the value of which must be a character representable as a \fBwchar_t\fR, and must be a wide-character code corresponding to a valid character in the current locale or the value of \fBWEOF\fR. If the argument has any other value, the argument is returned unchanged. If the argument of \fBtowlower()\fR represents an upper-case wide-character code, and there exists a corresponding lower-case wide-character code (as defined by character type information in the program locale category \fB\fR\fBLC_CTYPE\fR\fB),  \fR the result is the corresponding lower-case wide-character code. All other arguments in the domain are returned unchanged.
.SH RETURN VALUES
.sp
.LP
On successful completion, \fBtowlower()\fR returns the lower-case letter corresponding to the argument passed. Otherwise, it returns the argument unchanged.
.SH ERRORS
.sp
.LP
No errors are defined.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
lw(2.75i) |lw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
\fBATTRIBUTE TYPE\fR\fBATTRIBUTE VALUE\fR
_
CSIEnabled
_
Interface StabilityStandard
_
MT-LevelMT-Safe
.TE

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