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

\fBint\fR \fBtolower\fR(\fBint\fR \fIc\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The \fBtolower()\fR function has as a domain a type \fBint\fR, the value of which is representable as an \fBunsigned char\fR or the value of \fBEOF\fR. If the argument has any other value, the argument is returned unchanged. If the argument of \fBtolower()\fR represents an upper-case letter, and there exists a corresponding lower-case letter (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 letter. All other arguments in the domain are returned unchanged.
.SH RETURN VALUES
.sp
.LP
On successful completion, \fBtolower()\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
\fB_tolower\fR(3C), \fBsetlocale\fR(3C), \fBattributes\fR(5), \fBstandards\fR(5)