1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
2 .\" and Copyright (C) 2014 Michael Kerrisk <mtk.manpages@gmail.com>
4 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
5 .\" This is free documentation; you can redistribute it and/or
6 .\" modify it under the terms of the GNU General Public License as
7 .\" published by the Free Software Foundation; either version 2 of
8 .\" the License, or (at your option) any later version.
11 .\" References consulted:
12 .\" GNU glibc-2 source code and manual
13 .\" Dinkumware C library reference http://www.dinkumware.com/
14 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
17 .TH TOWLOWER 3 2017-09-15 "GNU" "Linux Programmer's Manual"
19 towlower, towlower_l \- convert a wide character to lowercase
22 .B #include <wctype.h>
24 .BI "wint_t towlower(wint_t " wc );
26 .BI "wint_t towlower_l(wint_t " wc ", locale_t " locale );
30 Feature Test Macro Requirements for glibc (see
31 .BR feature_test_macros (7)):
39 _XOPEN_SOURCE\ >=\ 700
48 function is the wide-character equivalent of the
53 is an uppercase wide character,
54 and there exists a lowercase equivalent in the current locale,
55 it returns the lowercase equivalent of
59 is returned unchanged.
63 function performs the same task,
64 but performs the conversion based on the character type information in
65 the locale specified by
71 is the special locale object
75 or is not a valid locale object handle.
79 must be representable as a
81 and be a valid character in the locale or be the value
86 was convertible to lowercase,
88 returns its lowercase equivalent;
94 function first appeared in glibc 2.3.
96 For an explanation of the terms used in this section, see
102 Interface Attribute Value
105 T} Thread safety MT-Safe locale
108 T} Thread safety MT-Safe
112 C99, POSIX.1-2001 (XSI);
113 present as an XSI extension in POSIX.1-2008, but marked obsolete.
118 The behavior of these functions depends on the
120 category of the locale.
122 These functions are not very appropriate for dealing with Unicode characters,
123 because Unicode knows about three cases: upper, lower and title case.