]> git.saurik.com Git - apple/libc.git/blob - locale/FreeBSD/mbsrtowcs.3.patch
Libc-391.4.1.tar.gz
[apple/libc.git] / locale / FreeBSD / mbsrtowcs.3.patch
1 --- mbsrtowcs.3.orig Fri Mar 11 18:09:42 2005
2 +++ mbsrtowcs.3 Fri Mar 11 18:11:17 2005
3 @@ -28,7 +28,9 @@
4 .Os
5 .Sh NAME
6 .Nm mbsrtowcs ,
7 -.Nm mbsnrtowcs
8 +.Nm mbsnrtowcs ,
9 +.Nm mbsrtowcs_l ,
10 +.Nm mbsnrtowcs_l
11 .Nd "convert a character string to a wide-character string (restartable)"
12 .Sh LIBRARY
13 .Lb libc
14 @@ -44,6 +46,17 @@
15 .Fa "wchar_t * restrict dst" "const char ** restrict src" "size_t nms"
16 .Fa "size_t len" "mbstate_t * restrict ps"
17 .Fc
18 +.In xlocale.h
19 +.Ft size_t
20 +.Fo mbsrtowcs_l
21 +.Fa "wchar_t * restrict dst" "const char ** restrict src" "size_t len"
22 +.Fa "mbstate_t * restrict ps" "locale_t loc"
23 +.Fc
24 +.Ft size_t
25 +.Fo mbsnrtowcs_l
26 +.Fa "wchar_t * restrict dst" "const char ** restrict src" "size_t nms"
27 +.Fa "size_t len" "mbstate_t * restrict ps" "locale_t loc"
28 +.Fc
29 .Sh DESCRIPTION
30 The
31 .Fn mbsrtowcs
32 @@ -97,6 +110,18 @@
33 .Fa nms
34 bytes from the buffer pointed to by
35 .Fa src .
36 +.Pp
37 +While the
38 +.Fn mbsrtowcs
39 +and
40 +.Fn mbsnrtowcs
41 +functions use the current locale, the
42 +.Fn mbsrtowcs_l
43 +and
44 +.Fn mbsnrtowcs_l
45 +functions may be passed locales directly. See
46 +.Xr xlocale 3
47 +for more information.
48 .Sh RETURN VALUES
49 The
50 .Fn mbsrtowcs
51 @@ -123,7 +148,8 @@
52 .Xr mbrtowc 3 ,
53 .Xr mbstowcs 3 ,
54 .Xr multibyte 3 ,
55 -.Xr wcsrtombs 3
56 +.Xr wcsrtombs 3 ,
57 +.Xr xlocale 3
58 .Sh STANDARDS
59 The
60 .Fn mbsrtowcs