| | 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 |
projects / apple / libc.git / blame_incremental