Libc-1082.50.1.tar.gz

[apple/libc.git] / locale / FreeBSD / wcrtomb.3

diff --git a/locale/FreeBSD/wcrtomb.3 b/locale/FreeBSD/wcrtomb.3
index 432eddf34f81a116a0b4b12c12291127487375fa..2b320a2c13b6ba6e353c6de23dfc09b03ebc1b5d 100644 (file)
--- a/locale/FreeBSD/wcrtomb.3
+++ b/locale/FreeBSD/wcrtomb.3
@@ -28,14 +28,28 @@
 .Dt WCRTOMB 3
 .Os
 .Sh NAME
-.Nm wcrtomb
+.Nm wcrtomb ,
+.Nm wcrtomb_l
 .Nd "convert a wide-character code to a character (restartable)"
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In wchar.h
 .Ft size_t
-.Fn wcrtomb "char * restrict s" "wchar_t wc" "mbstate_t * restrict ps"
+.Fo wcrtomb
+.Fa "char *restrict s"
+.Fa "wchar_t wc"
+.Fa "mbstate_t *restrict ps"
+.Fc
+.In wchar.h
+.In xlocale.h
+.Ft size_t
+.Fo wcrtomb_l
+.Fa "char *restrict s"
+.Fa "wchar_t wc"
+.Fa "mbstate_t *restrict ps"
+.Fa "locale_t loc"
+.Fc
 .Sh DESCRIPTION
 The
 .Fn wcrtomb
@@ -44,10 +58,10 @@ wide character
 .Fa wc ,
 including any necessary shift sequences, to the
 character array
-.Fa s ,
-storing a maximum of
+.Fa s .
+A maximum of
 .Dv MB_CUR_MAX
-bytes.
+bytes will be stored.
 .Pp
 If
 .Fa s
@@ -58,7 +72,7 @@ behaves as if
 .Fa s
 pointed to an internal buffer and
 .Fa wc
-was a null wide character (L'\e0').
+were a null wide character (L'\e0').
 .Pp
 The
 .Ft mbstate_t
@@ -72,6 +86,14 @@ uses an internal, static
 .Vt mbstate_t
 object, which is initialized to the initial conversion state
 at program startup.
+.Pp
+While the
+.Fn wcrtomb
+function uses the current locale, the
+.Fn wcrtomb_l
+function may be passed a locale directly. See
+.Xr xlocale 3
+for more information.
 .Sh RETURN VALUES
 The
 .Fn wcrtomb
@@ -97,7 +119,8 @@ The conversion state is invalid.
 .Xr mbrtowc 3 ,
 .Xr multibyte 3 ,
 .Xr setlocale 3 ,
-.Xr wctomb 3
+.Xr wctomb 3 ,
+.Xr xlocale 3
 .Sh STANDARDS
 The
 .Fn wcrtomb