Print this page
Garrett's man page edits.
*** 9,84 ****
.\" source. A copy of the CDDL is also available via the Internet at
.\" http://www.illumos.org/license/CDDL.
.\"
.\"
.\" Copyright (c) 2014 Joyent, Inc. All rights reserved.
.\"
! .TH TOWUPPER 3C "Jun 11, 2014"
!
.SH NAME
-
towupper, towupper_l \- transliterate lower-case wide characters to upper-case
-
.SH SYNOPSIS
-
.LP
.nf
#include <wctype.h>
! .BI "wint_t towupper(wint_t" wc );
! .BI "wint_t towupper_l(wint_t" wc, " locale_t " loc );
!
.SH DESCRIPTION
-
The function
! .BR towupper
is the wide character equivalent of the function
! .BR toupper .
It converts the lower-case wide character
! .I loc
to the equivalent upper-case
wide character, if one exists. If one does not exist, it returns
! .I loc
unchanged.
-
.LP
The function
! .B towupper_l
is equivalent to the function
! .BR towupper ,
! but instead of operating in the current environemnt, operates on the
! environment specified by
.IR loc .
-
.SH RETURN VALUES
-
On successful completion,
.B towupper()
and
.B towupper_l()
return the upper-case character that corresponds to the argument passed.
Otherwise, they return the argument unchanged.
-
.SH ERRORS
-
No errors are defined.
-
.SH ATTRIBUTES
- .sp
.TS
box;
c | c
l | l .
ATTRIBUTE TYPE ATTRIBUTE VALUE
_
Interface Stability Standard
_
! MT-Level Safe
.TE
.SH SEE ALSO
- .BR duplocale (3C),
.BR newlocale (3C),
.BR setlocale (3C),
! .BR tolower(3C),
! .BR environ (5),
.BR locale (5)
--- 9,75 ----
.\" source. A copy of the CDDL is also available via the Internet at
.\" http://www.illumos.org/license/CDDL.
.\"
.\"
.\" Copyright (c) 2014 Joyent, Inc. All rights reserved.
+ .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
.\"
! .TH TOWUPPER 3C "Jun 21, 2014"
.SH NAME
towupper, towupper_l \- transliterate lower-case wide characters to upper-case
.SH SYNOPSIS
.LP
.nf
#include <wctype.h>
! \fBwint_t\fR \fBtowupper\fR(\fBwint_t\fR \fIwc\fR);
! .fi
! .LP
! .nf
! \fBwint_t\fR \fBtowupper_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
! .fi
.SH DESCRIPTION
The function
! .BR towupper()
is the wide character equivalent of the function
! .BR toupper (3C).
It converts the lower-case wide character
! .I wc
to the equivalent upper-case
wide character, if one exists. If one does not exist, it returns
! .I wc
unchanged.
.LP
The function
! .B towupper_l()
is equivalent to the function
! .BR towupper() ,
! but instead of operating in the current locale, operates in the
! locale specified by
.IR loc .
.SH RETURN VALUES
On successful completion,
.B towupper()
and
.B towupper_l()
return the upper-case character that corresponds to the argument passed.
Otherwise, they return the argument unchanged.
.SH ERRORS
No errors are defined.
.SH ATTRIBUTES
.TS
box;
c | c
l | l .
ATTRIBUTE TYPE ATTRIBUTE VALUE
_
Interface Stability Standard
_
! MT-Level MT-Safe
.TE
.SH SEE ALSO
.BR newlocale (3C),
.BR setlocale (3C),
! .BR toupper(3C),
! .BR uselocale (3C),
.BR locale (5)