--- wcsrtombs.3.orig Fri Mar 11 18:15:27 2005 +++ wcsrtombs.3 Fri Mar 11 18:18:11 2005 @@ -29,7 +29,9 @@ .Os .Sh NAME .Nm wcsrtombs , -.Nm wcsnrtombs +.Nm wcsnrtombs , +.Nm wcsrtombs_l , +.Nm wcsnrtombs_l .Nd "convert a wide-character string to a character string (restartable)" .Sh LIBRARY .Lb libc @@ -45,6 +47,17 @@ .Fa "char * restrict dst" "const wchar_t ** restrict src" "size_t nwc" .Fa "size_t len" "mbstate_t * restrict ps" .Fc +.In xlocale.h +.Ft size_t +.Fo wcsrtombs_l +.Fa "char * restrict dst" "const wchar_t ** restrict src" +.Fa "size_t len" "mbstate_t * restrict ps" "locale_t loc" +.Fc +.Ft size_t +.Fo wcsnrtombs_l +.Fa "char * restrict dst" "const wchar_t ** restrict src" "size_t nwc" +.Fa "size_t len" "mbstate_t * restrict ps" "locale_t loc" +.Fc .Sh DESCRIPTION The .Fn wcsrtombs @@ -97,6 +110,18 @@ .Fa nwc characters from the buffer pointed to by .Fa src . +.Pp +While the +.Fn wcsrtombs +and +.Fn wcsnrtombs +functions use the current locale, the +.Fn wcsrtombs_l +and +.Fn wcsnrtombs_l +functions may be passed locales directly. See +.Xr xlocale 3 +for more information. .Sh RETURN VALUES The .Fn wcsrtombs @@ -122,7 +147,8 @@ .Sh SEE ALSO .Xr mbsrtowcs 3 , .Xr wcrtomb 3 , -.Xr wcstombs 3 +.Xr wcstombs 3 , +.Xr xlocale 3 .Sh STANDARDS The .Fn wcsrtombs