]> git.saurik.com Git - apple/libc.git/blob - locale/FreeBSD/btowc.3.patch
Libc-594.9.5.tar.gz
[apple/libc.git] / locale / FreeBSD / btowc.3.patch
1 --- btowc.3 2003-05-20 15:21:44.000000000 -0700
2 +++ btowc.3.edit 2006-07-12 11:14:18.000000000 -0700
3 @@ -29,16 +29,35 @@
4 .Os
5 .Sh NAME
6 .Nm btowc ,
7 -.Nm wctob
8 +.Nm btowc_l ,
9 +.Nm wctob ,
10 +.Nm wctob_l
11 .Nd "convert between wide and single-byte characters"
12 .Sh LIBRARY
13 .Lb libc
14 .Sh SYNOPSIS
15 +.In stdio.h
16 .In wchar.h
17 .Ft wint_t
18 -.Fn btowc "int c"
19 +.Fo btowc
20 +.Fa "int c"
21 +.Fc
22 .Ft int
23 -.Fn wctob "wint_t c"
24 +.Fo wctob
25 +.Fa "wint_t c"
26 +.Fc
27 +.In wchar.h
28 +.In xlocale.h
29 +.Ft wint_t
30 +.Fo btowc_l
31 +.Fa "int c"
32 +.Fa "locale_t loc"
33 +.Fc
34 +.Ft int
35 +.Fo wctob_l
36 +.Fa "wint_t c"
37 +.Fa "locale_t loc"
38 +.Fc
39 .Sh DESCRIPTION
40 The
41 .Fn btowc
42 @@ -59,10 +78,29 @@
43 .Fn wctob
44 returns
45 .Dv WEOF .
46 +.Pp
47 +While the
48 +.Fn btowc
49 +and
50 +.Fn wctob
51 +functions use the current locale, the
52 +.Fn btowc_l
53 +and
54 +.Fn wctob_l
55 +functions may be passed locales directly. See
56 +.Xr xlocale 3
57 +for more information.
58 +.Sh LEGACY SYNOPSIS
59 +.Pp
60 +The include file
61 +.In stdio.h
62 +is not necessary for these functions.
63 .Sh SEE ALSO
64 .Xr mbrtowc 3 ,
65 .Xr multibyte 3 ,
66 -.Xr wcrtomb 3
67 +.Xr wcrtomb 3 ,
68 +.Xr xlocale 3 ,
69 +.Xr compat 5
70 .Sh STANDARDS
71 The
72 .Fn btowc