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

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

.SH DESCRIPTION
.sp
.LP
The \fBtoupper()\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 \fBtoupper()\fR represents a lower-case letter, and there exists a corresponding upper-case letter (as defined by character type information in the program locale category \fBLC_CTYPE\fR),   the result is the corresponding upper-case letter. All other arguments in the domain are returned unchanged.
.SH RETURN VALUES
.sp
.LP
On successful completion, \fBtoupper()\fR returns the upper-case letter corresponding to the argument passed.
.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_toupper\fR(3C), \fBsetlocale\fR(3C), \fBattributes\fR(5), \fBstandards\fR(5)