]> git.saurik.com Git - apple/libc.git/blame - locale/FreeBSD/wctomb.3.patch
Libc-391.tar.gz
[apple/libc.git] / locale / FreeBSD / wctomb.3.patch
CommitLineData
3d9156a7
A
1--- wctomb.3.orig Fri Mar 11 19:44:47 2005
2+++ wctomb.3 Fri Mar 11 19:47:38 2005
3@@ -41,7 +41,8 @@
4 .Dt WCTOMB 3
5 .Os
6 .Sh NAME
7-.Nm wctomb
8+.Nm wctomb ,
9+.Nm wctomb_l
10 .Nd convert a wide-character code to a character
11 .Sh LIBRARY
12 .Lb libc
13@@ -49,6 +50,9 @@
14 .In stdlib.h
15 .Ft int
16 .Fn wctomb "char *mbchar" "wchar_t wchar"
17+.In xlocale.h
18+.Ft int
19+.Fn wctomb_l "char *mbchar" "wchar_t wchar" "locale_t loc"
20 .Sh DESCRIPTION
21 The
22 .Fn wctomb
23@@ -69,6 +73,14 @@
24 pointer returns nonzero if the current locale requires shift states,
25 zero otherwise;
26 if shift states are required, the shift state is reset to the initial state.
27+.Pp
28+While the
29+.Fn wctomb
30+function uses the current locale, the
31+.Fn wctomb_l
32+function may be passed a locale directly. See
33+.Xr xlocale 3
34+for more information.
35 .Sh RETURN VALUES
36 If
37 .Fa mbchar
38@@ -104,7 +116,8 @@
39 .Xr mbtowc 3 ,
40 .Xr wcrtomb 3 ,
41 .Xr wcstombs 3 ,
42-.Xr wctob 3
43+.Xr wctob 3 ,
44+.Xr xlocale 3
45 .Sh STANDARDS
46 The
47 .Fn wctomb