]> git.saurik.com Git - apple/libc.git/blob - locale/FreeBSD/mbtowc.3.patch
Libc-391.4.1.tar.gz
[apple/libc.git] / locale / FreeBSD / mbtowc.3.patch
1 --- mbtowc.3.orig Fri Mar 11 19:44:47 2005
2 +++ mbtowc.3 Fri Mar 11 19:54:09 2005
3 @@ -41,7 +41,8 @@
4 .Dt MBTOWC 3
5 .Os
6 .Sh NAME
7 -.Nm mbtowc
8 +.Nm mbtowc ,
9 +.Nm mbtowc_l
10 .Nd convert a character to a wide-character code
11 .Sh LIBRARY
12 .Lb libc
13 @@ -52,6 +53,12 @@
14 .Fa "wchar_t * restrict wcharp" "const char * restrict mbchar"
15 .Fa "size_t nbytes"
16 .Fc
17 +.In xlocale.h
18 +.Ft int
19 +.Fo mbtowc_l
20 +.Fa "wchar_t * restrict wcharp" "const char * restrict mbchar"
21 +.Fa "size_t nbytes" "locale_t loc"
22 +.Fc
23 .Sh DESCRIPTION
24 The
25 .Fn mbtowc
26 @@ -70,6 +77,14 @@
27 pointer returns nonzero if the current encoding requires shift states,
28 zero otherwise;
29 if shift states are required, the shift state is reset to the initial state.
30 +.Pp
31 +While the
32 +.Fn mbtowc
33 +function uses the current locale, the
34 +.Fn mbtowc_l
35 +function may be passed a locale directly. See
36 +.Xr xlocale 3
37 +for more information.
38 .Sh RETURN VALUES
39 If
40 .Fa mbchar
41 @@ -110,7 +125,8 @@
42 .Xr mbrtowc 3 ,
43 .Xr mbstowcs 3 ,
44 .Xr multibyte 3 ,
45 -.Xr wctomb 3
46 +.Xr wctomb 3 ,
47 +.Xr xlocale 3
48 .Sh STANDARDS
49 The
50 .Fn mbtowc