projects / apple / libc.git / blame
| Commit | Line | Data |
|---|---|---|
| 3d9156a7 A |
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 |