Print this page
Garrett's man page edits.
Split |
Close |
Expand all |
Collapse all |
--- old/usr/src/man/man3c/towupper.3c
+++ new/usr/src/man/man3c/towupper.3c
1 1 '\" te
2 2 .\"
3 3 .\" This file and its contents are supplied under the terms of the
↓ open down ↓ |
3 lines elided |
↑ open up ↑ |
4 4 .\" Common Development and Distribution License ("CDDL"), version 1.0.
5 5 .\" You may only use this file in accordance with the terms of version
6 6 .\" 1.0 of the CDDL.
7 7 .\"
8 8 .\" A full copy of the text of the CDDL should have accompanied this
9 9 .\" source. A copy of the CDDL is also available via the Internet at
10 10 .\" http://www.illumos.org/license/CDDL.
11 11 .\"
12 12 .\"
13 13 .\" Copyright (c) 2014 Joyent, Inc. All rights reserved.
14 +.\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
14 15 .\"
15 -.TH TOWUPPER 3C "Jun 11, 2014"
16 -
16 +.TH TOWUPPER 3C "Jun 21, 2014"
17 17 .SH NAME
18 -
19 18 towupper, towupper_l \- transliterate lower-case wide characters to upper-case
20 -
21 19 .SH SYNOPSIS
22 -
23 20 .LP
24 21 .nf
25 22 #include <wctype.h>
26 23
27 -.BI "wint_t towupper(wint_t" wc );
28 -.BI "wint_t towupper_l(wint_t" wc, " locale_t " loc );
29 -
24 +\fBwint_t\fR \fBtowupper\fR(\fBwint_t\fR \fIwc\fR);
25 +.fi
26 +.LP
27 +.nf
28 +\fBwint_t\fR \fBtowupper_l\fR(\fBwint_t\fR \fIwc\fR, \fBlocale_t\fR \fIloc\fR);
29 +.fi
30 30 .SH DESCRIPTION
31 -
32 31 The function
33 -.BR towupper
32 +.BR towupper()
34 33 is the wide character equivalent of the function
35 -.BR toupper .
34 +.BR toupper (3C).
36 35 It converts the lower-case wide character
37 -.I loc
36 +.I wc
38 37 to the equivalent upper-case
39 38 wide character, if one exists. If one does not exist, it returns
40 -.I loc
39 +.I wc
41 40 unchanged.
42 -
43 41 .LP
44 42 The function
45 -.B towupper_l
43 +.B towupper_l()
46 44 is equivalent to the function
47 -.BR towupper ,
48 -but instead of operating in the current environemnt, operates on the
49 -environment specified by
45 +.BR towupper() ,
46 +but instead of operating in the current locale, operates in the
47 +locale specified by
50 48 .IR loc .
51 -
52 49 .SH RETURN VALUES
53 -
54 50 On successful completion,
55 51 .B towupper()
56 52 and
57 53 .B towupper_l()
58 54 return the upper-case character that corresponds to the argument passed.
59 55 Otherwise, they return the argument unchanged.
60 -
61 56 .SH ERRORS
62 -
63 57 No errors are defined.
64 -
65 58 .SH ATTRIBUTES
66 -.sp
67 59 .TS
68 60 box;
69 61 c | c
70 62 l | l .
71 63 ATTRIBUTE TYPE ATTRIBUTE VALUE
72 64 _
73 65 Interface Stability Standard
74 66 _
75 -MT-Level Safe
67 +MT-Level MT-Safe
76 68 .TE
77 69
78 70 .SH SEE ALSO
79 -.BR duplocale (3C),
80 71 .BR newlocale (3C),
81 72 .BR setlocale (3C),
82 -.BR tolower(3C),
83 -.BR environ (5),
73 +.BR toupper(3C),
74 +.BR uselocale (3C),
84 75 .BR locale (5)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX