locale/FreeBSD/mbstowcs.3.patch

   1 --- mbstowcs.3.orig     Fri Mar 11 19:44:47 2005
   2 +++ mbstowcs.3  Fri Mar 11 20:01:09 2005
   3 @@ -41,7 +41,8 @@
   4  .Dt MBSTOWCS 3
   5  .Os
   6  .Sh NAME
   7 -.Nm mbstowcs
   8 +.Nm mbstowcs ,
   9 +.Nm mbstowcs_l
  10  .Nd convert a character string to a wide-character string
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -52,6 +53,12 @@
  14  .Fa "wchar_t * restrict wcstring" "const char * restrict mbstring"
  15  .Fa "size_t nwchars"
  16  .Fc
  17 +.In xlocale.h
  18 +.Ft size_t
  19 +.Fo mbstowcs_l
  20 +.Fa "wchar_t * restrict wcstring" "const char * restrict mbstring"
  21 +.Fa "size_t nwchars" "locale_t loc"
  22 +.Fc
  23  .Sh DESCRIPTION
  24  The
  25  .Fn mbstowcs
  26 @@ -64,6 +71,14 @@
  27  .Fa nwchars
  28  wide characters are stored.
  29  A terminating null wide character is appended if there is room.
  30 +.Pp
  31 +While the
  32 +.Fn mbstowcs
  33 +function uses the current locale, the
  34 +.Fn mbstowcs_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 mbstowcs
  41 @@ -83,7 +98,8 @@
  42  .Sh SEE ALSO
  43  .Xr mbsrtowcs 3 ,
  44  .Xr mbtowc 3 ,
  45 -.Xr multibyte 3
  46 +.Xr multibyte 3 ,
  47 +.Xr xlocale 3
  48  .Sh STANDARDS
  49  The
  50  .Fn mbstowcs