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