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

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

.SH DESCRIPTION
.sp
.LP
The \fBtowupper()\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 \fBtowupper()\fR represents a 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 upper-case wide-character code. All other arguments in the domain are returned unchanged.
.SH RETURN VALUES
.sp
.LP
Upon successful completion, \fBtowupper()\fR returns the upper-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), \fBtowlower\fR(3C), \fBattributes\fR(5), \fBstandards\fR(5)