1*3a628b46Sschwarze.\" $OpenBSD: towlower.3,v 1.6 2017/09/05 03:16:13 schwarze Exp $ 25c0c174aSespie.\" $NetBSD: towlower.3,v 1.7 2003/09/08 17:54:31 wiz Exp $ 35c0c174aSespie.\" 45c0c174aSespie.\" Copyright (c) 1989, 1991 The Regents of the University of California. 55c0c174aSespie.\" All rights reserved. 65c0c174aSespie.\" 75c0c174aSespie.\" This code is derived from software contributed to Berkeley by 85c0c174aSespie.\" the American National Standards Committee X3, on Information 95c0c174aSespie.\" Processing Systems. 105c0c174aSespie.\" 115c0c174aSespie.\" Redistribution and use in source and binary forms, with or without 125c0c174aSespie.\" modification, are permitted provided that the following conditions 135c0c174aSespie.\" are met: 145c0c174aSespie.\" 1. Redistributions of source code must retain the above copyright 155c0c174aSespie.\" notice, this list of conditions and the following disclaimer. 165c0c174aSespie.\" 2. Redistributions in binary form must reproduce the above copyright 175c0c174aSespie.\" notice, this list of conditions and the following disclaimer in the 185c0c174aSespie.\" documentation and/or other materials provided with the distribution. 195c0c174aSespie.\" 3. Neither the name of the University nor the names of its contributors 205c0c174aSespie.\" may be used to endorse or promote products derived from this software 215c0c174aSespie.\" without specific prior written permission. 225c0c174aSespie.\" 235c0c174aSespie.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 245c0c174aSespie.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 255c0c174aSespie.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 265c0c174aSespie.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 275c0c174aSespie.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 285c0c174aSespie.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 295c0c174aSespie.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 305c0c174aSespie.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 315c0c174aSespie.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 325c0c174aSespie.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 335c0c174aSespie.\" SUCH DAMAGE. 345c0c174aSespie.\" 355c0c174aSespie.\" @(#)tolower.3 5.2 (Berkeley) 6/29/91 365c0c174aSespie.\" 37*3a628b46Sschwarze.Dd $Mdocdate: September 5 2017 $ 385c0c174aSespie.Dt TOWLOWER 3 395c0c174aSespie.Os 405c0c174aSespie.Sh NAME 4165612907Sschwarze.Nm towlower , 42*3a628b46Sschwarze.Nm towlower_l , 43*3a628b46Sschwarze.Nm towupper , 44*3a628b46Sschwarze.Nm towupper_l 45fbad59fbSjmc.Nd wide-character case letter conversion utilities 465c0c174aSespie.Sh SYNOPSIS 475c0c174aSespie.In wctype.h 485c0c174aSespie.Ft wint_t 495c0c174aSespie.Fn towlower "wint_t wc" 505c0c174aSespie.Ft wint_t 51*3a628b46Sschwarze.Fn towlower_l "wint_t wc" "locale_t locale" 52*3a628b46Sschwarze.Ft wint_t 535c0c174aSespie.Fn towupper "wint_t wc" 54*3a628b46Sschwarze.Ft wint_t 55*3a628b46Sschwarze.Fn towupper_l "wint_t wc" "locale_t locale" 565c0c174aSespie.Sh DESCRIPTION 575c0c174aSespieThe 585c0c174aSespie.Fn towlower 59*3a628b46Sschwarzeand 60*3a628b46Sschwarze.Fn towlower_l 61*3a628b46Sschwarzefunctions convert an upper-case wide character 62*3a628b46Sschwarzeto the corresponding lower-case letter. 635c0c174aSespieThe 645c0c174aSespie.Fn towupper 65*3a628b46Sschwarzeand 66*3a628b46Sschwarze.Fn towupper_l 67*3a628b46Sschwarzefunctions convert a lower-case wide character 68*3a628b46Sschwarzeto the corresponding upper-case letter. 69*3a628b46Sschwarze.Pp 70*3a628b46SschwarzeThe functions 71*3a628b46Sschwarze.Fn towlower_l 72*3a628b46Sschwarzeand 73*3a628b46Sschwarze.Fn towupper_l 74*3a628b46Sschwarzeuse the specified 75*3a628b46Sschwarze.Fa locale , 76*3a628b46Sschwarzewhereas 77*3a628b46Sschwarze.Fn towlower 78*3a628b46Sschwarzeand 79*3a628b46Sschwarze.Fn towupper 80*3a628b46Sschwarzeuse the thread-specific locale set with 81*3a628b46Sschwarze.Xr uselocale 3 , 82*3a628b46Sschwarzefalling back to the global locale set with 83*3a628b46Sschwarze.Xr setlocale 3 . 845c0c174aSespie.Sh RETURN VALUES 85*3a628b46SschwarzeThese functions return the corresponding character, if any. 86*3a628b46SschwarzeOtherwise, 87*3a628b46Sschwarze.Fa wc 88*3a628b46Sschwarzeis returned unchanged. 895c0c174aSespie.Sh SEE ALSO 90*3a628b46Sschwarze.Xr iswlower 3 , 915c0c174aSespie.Xr tolower 3 , 92*3a628b46Sschwarze.Xr toupper 3 , 93*3a628b46Sschwarze.Xr towctrans 3 945c0c174aSespie.Sh STANDARDS 95*3a628b46SschwarzeThe functions 96*3a628b46Sschwarze.Fn towlower 97*3a628b46Sschwarzeand 98*3a628b46Sschwarze.Fn towupper 99*3a628b46Sschwarzeconform to 100b875387eSjmc.St -isoC-amd1 101b875387eSjmcand 102*3a628b46Sschwarze.St -isoC-99 , 103*3a628b46Sschwarzeand 104*3a628b46Sschwarze.Fn towlower_l 105*3a628b46Sschwarzeand 106*3a628b46Sschwarze.Fn towupper_l 107*3a628b46Sschwarzeto 108*3a628b46Sschwarze.St -p1003.1-2008 . 109*3a628b46Sschwarze.Sh HISTORY 110*3a628b46SschwarzeThe functions 111*3a628b46Sschwarze.Fn towlower 112*3a628b46Sschwarzeand 113*3a628b46Sschwarze.Fn towupper 114*3a628b46Sschwarzehave been available since 115*3a628b46Sschwarze.Ox 3.8 , 116*3a628b46Sschwarzeand 117*3a628b46Sschwarze.Fn towlower_l 118*3a628b46Sschwarzeand 119*3a628b46Sschwarze.Fn towupper_l 120*3a628b46Sschwarzesince 121*3a628b46Sschwarze.Ox 6.2 . 122