]> git.saurik.com Git - apple/libc.git/blob - locale/FreeBSD/tolower.3.patch
Libc-763.12.tar.gz
[apple/libc.git] / locale / FreeBSD / tolower.3.patch
1 --- tolower.3.bsdnew 2009-11-10 13:13:11.000000000 -0800
2 +++ tolower.3 2009-11-10 13:51:11.000000000 -0800
3 @@ -36,14 +36,24 @@
4 .Dt TOLOWER 3
5 .Os
6 .Sh NAME
7 -.Nm tolower
8 +.Nm tolower ,
9 +.Nm tolower_l
10 .Nd upper case to lower case letter conversion
11 .Sh LIBRARY
12 .Lb libc
13 .Sh SYNOPSIS
14 .In ctype.h
15 .Ft int
16 -.Fn tolower "int c"
17 +.Fo tolower
18 +.Fa "int c"
19 +.Fc
20 +.In ctype.h
21 +.In xlocale.h
22 +.Ft int
23 +.Fo tolower_l
24 +.Fa "int c"
25 +.Fa "locale_t loc"
26 +.Fc
27 .Sh DESCRIPTION
28 The
29 .Fn tolower
30 @@ -53,11 +63,19 @@ The argument must be representable as an
31 .Vt "unsigned char"
32 or the value of
33 .Dv EOF .
34 +.Pp
35 +Although the
36 +.Fn tolower
37 +function uses the current locale, the
38 +.Fn tolower_l
39 +function may be passed a locale directly. See
40 +.Xr xlocale 3
41 +for more information.
42 .Sh RETURN VALUES
43 If the argument is an upper-case letter, the
44 .Fn tolower
45 function returns the corresponding lower-case letter if there is
46 -one; otherwise the argument is returned unchanged.
47 +one; otherwise, the argument is returned unchanged.
48 .Sh COMPATIBILITY
49 The
50 .Bx 4.4
51 @@ -71,7 +89,8 @@ function should be used instead.
52 .Sh SEE ALSO
53 .Xr ctype 3 ,
54 .Xr islower 3 ,
55 -.Xr towlower 3
56 +.Xr towlower 3 ,
57 +.Xr xlocale 3
58 .Sh STANDARDS
59 The
60 .Fn tolower