Libc-1082.50.1.tar.gz

[apple/libc.git] / locale / FreeBSD / tolower.3

diff --git a/locale/FreeBSD/tolower.3 b/locale/FreeBSD/tolower.3
index 29515bb0bfc74358f3dbdad101df9cea00c8bc2f..0ac4aba66e4999403550613ac585daa6308d2aad 100644 (file)
--- a/locale/FreeBSD/tolower.3
+++ b/locale/FreeBSD/tolower.3
@@ -36,14 +36,24 @@
 .Dt TOLOWER 3
 .Os
 .Sh NAME
 .Dt TOLOWER 3
 .Os
 .Sh NAME

-.Nm tolower
+.Nm tolower ,
+.Nm tolower_l

 .Nd upper case to lower case letter conversion
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In ctype.h
 .Ft int
 .Nd upper case to lower case letter conversion
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In ctype.h
 .Ft int

-.Fn tolower "int c"
+.Fo tolower
+.Fa "int c"
+.Fc
+.In ctype.h
+.In xlocale.h
+.Ft int
+.Fo tolower_l
+.Fa "int c"
+.Fa "locale_t loc"
+.Fc

 .Sh DESCRIPTION
 The
 .Fn tolower
 .Sh DESCRIPTION
 The
 .Fn tolower


@@ -53,11 +63,19 @@ The argument must be representable as an
 .Vt "unsigned char"
 or the value of
 .Dv EOF .
 .Vt "unsigned char"
 or the value of
 .Dv EOF .

+.Pp
+Although the
+.Fn tolower
+function uses the current locale, the
+.Fn tolower_l
+function may be passed a locale directly. See
+.Xr xlocale 3
+for more information.

 .Sh RETURN VALUES
 If the argument is an upper-case letter, the
 .Fn tolower
 function returns the corresponding lower-case letter if there is
 .Sh RETURN VALUES
 If the argument is an upper-case letter, the
 .Fn tolower
 function returns the corresponding lower-case letter if there is

-one; otherwise the argument is returned unchanged.
+one; otherwise, the argument is returned unchanged.

 .Sh COMPATIBILITY
 The
 .Bx 4.4
 .Sh COMPATIBILITY
 The
 .Bx 4.4


@@ -71,7 +89,8 @@ function should be used instead.
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr islower 3 ,
 .Sh SEE ALSO
 .Xr ctype 3 ,
 .Xr islower 3 ,

-.Xr towlower 3
+.Xr towlower 3 ,
+.Xr xlocale 3

 .Sh STANDARDS
 The
 .Fn tolower
 .Sh STANDARDS
 The
 .Fn tolower