]> git.saurik.com Git - apple/libc.git/blob - locale/FreeBSD/mbrtowc.3.patch
Libc-391.4.1.tar.gz
[apple/libc.git] / locale / FreeBSD / mbrtowc.3.patch
1 --- mbrtowc.3.orig Fri Mar 11 19:44:47 2005
2 +++ mbrtowc.3 Fri Mar 11 19:55:59 2005
3 @@ -28,7 +28,8 @@
4 .Dt MBRTOWC 3
5 .Os
6 .Sh NAME
7 -.Nm mbrtowc
8 +.Nm mbrtowc ,
9 +.Nm mbrtowc_l
10 .Nd "convert a character to a wide-character code (restartable)"
11 .Sh LIBRARY
12 .Lb libc
13 @@ -39,6 +40,12 @@
14 .Fa "wchar_t * restrict pwc" "const char * restrict s" "size_t n"
15 .Fa "mbstate_t * restrict ps"
16 .Fc
17 +.In xlocale.h
18 +.Ft size_t
19 +.Fo mbrtowc_l
20 +.Fa "wchar_t * restrict pwc" "const char * restrict s" "size_t n"
21 +.Fa "mbstate_t * restrict ps" "locale_t loc"
22 +.Fc
23 .Sh DESCRIPTION
24 The
25 .Fn mbrtowc
26 @@ -86,6 +93,14 @@
27 .Vt mbstate_t
28 object, which is initialized to the initial conversion state
29 at program startup.
30 +.Pp
31 +While the
32 +.Fn mbrtowc
33 +function uses the current locale, the
34 +.Fn mbrtowc_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 mbrtowc
41 @@ -131,7 +146,8 @@
42 .Xr mbtowc 3 ,
43 .Xr multibyte 3 ,
44 .Xr setlocale 3 ,
45 -.Xr wcrtomb 3
46 +.Xr wcrtomb 3 ,
47 +.Xr xlocale 3
48 .Sh STANDARDS
49 The
50 .Fn mbrtowc