]> git.saurik.com Git - apple/libc.git/blame - locale/FreeBSD/wcstombs.3.patch
Libc-391.5.22.tar.gz
[apple/libc.git] / locale / FreeBSD / wcstombs.3.patch
CommitLineData
3d9156a7
A
1--- wcstombs.3.orig Fri Mar 11 19:44:47 2005
2+++ wcstombs.3 Fri Mar 11 19:48:16 2005
3@@ -41,7 +41,8 @@
4 .Dt WCSTOMBS 3
5 .Os
6 .Sh NAME
7-.Nm wcstombs
8+.Nm wcstombs ,
9+.Nm wcstombs_l
10 .Nd convert a wide-character string to a character string
11 .Sh LIBRARY
12 .Lb libc
13@@ -52,6 +53,12 @@
14 .Fa "char * restrict mbstring" "const wchar_t * restrict wcstring"
15 .Fa "size_t nbytes"
16 .Fc
17+.In xlocale.h
18+.Ft size_t
19+.Fo wcstombs_l
20+.Fa "char * restrict mbstring" "const wchar_t * restrict wcstring"
21+.Fa "size_t nbytes" "locale_t loc"
22+.Fc
23 .Sh DESCRIPTION
24 The
25 .Fn wcstombs
26@@ -66,6 +73,14 @@
27 .Fa mbstring .
28 Partial multibyte characters at the end of the string are not stored.
29 The multibyte character string is null terminated if there is room.
30+.Pp
31+While the
32+.Fn wcstombs
33+function uses the current locale, the
34+.Fn wcstombs_l
35+function may be passed a locale directly. See
36+.Xr xlocale 3
37+for more information.
38 .Sh RETURN VALUES
39 The
40 .Fn wcstombs
41@@ -86,7 +101,8 @@
42 .Xr mbstowcs 3 ,
43 .Xr multibyte 3 ,
44 .Xr wcsrtombs 3 ,
45-.Xr wctomb 3
46+.Xr wctomb 3 ,
47+.Xr xlocale 3
48 .Sh STANDARDS
49 The
50 .Fn wcstombs