Libc-1082.50.1.tar.gz

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

diff --git a/locale/FreeBSD/mbsinit.3 b/locale/FreeBSD/mbsinit.3
index e2a9e46143b0e36e0230bce4829c7c11dea09790..8dfa1bf3f7cf3e84effba30bcc238fb5010a201e 100644 (file)
--- a/locale/FreeBSD/mbsinit.3
+++ b/locale/FreeBSD/mbsinit.3
@@ -28,7 +28,8 @@
 .Dt MBSINIT 3
 .Os
 .Sh NAME
 .Dt MBSINIT 3
 .Os
 .Sh NAME

-.Nm mbsinit
+.Nm mbsinit ,
+.Nm mbsinit_l

 .Nd "determine conversion object status"
 .Sh LIBRARY
 .Lb libc
 .Nd "determine conversion object status"
 .Sh LIBRARY
 .Lb libc


@@ -36,6 +37,10 @@
 .In wchar.h
 .Ft int
 .Fn mbsinit "const mbstate_t *ps"
 .In wchar.h
 .Ft int
 .Fn mbsinit "const mbstate_t *ps"

+.In wchar.h
+.In xlocale.h
+.Ft int
+.Fn mbsinit_l "const mbstate_t *ps" "locale_t loc"

 .Sh DESCRIPTION
 The
 .Fn mbsinit
 .Sh DESCRIPTION
 The
 .Fn mbsinit


@@ -44,6 +49,14 @@ function determines whether the
 object pointed to by
 .Fa ps
 describes an initial conversion state.
 object pointed to by
 .Fa ps
 describes an initial conversion state.

+.Pp
+While the
+.Fn mbsinit
+function uses the current locale, the
+.Fn mbsinit_l
+function may be passed a locale directly. See
+.Xr xlocale 3
+for more information.

 .Sh RETURN VALUES
 The
 .Fn mbsinit
 .Sh RETURN VALUES
 The
 .Fn mbsinit


@@ -51,15 +64,16 @@ function returns non-zero if
 .Fa ps
 is
 .Dv NULL
 .Fa ps
 is
 .Dv NULL

-or describes an initial conversion state,
-otherwise it returns zero.
+or describes an initial conversion state;
+otherwise, it returns zero.

 .Sh SEE ALSO
 .Xr mbrlen 3 ,
 .Xr mbrtowc 3 ,
 .Xr mbsrtowcs 3 ,
 .Xr multibyte 3 ,
 .Xr wcrtomb 3 ,
 .Sh SEE ALSO
 .Xr mbrlen 3 ,
 .Xr mbrtowc 3 ,
 .Xr mbsrtowcs 3 ,
 .Xr multibyte 3 ,
 .Xr wcrtomb 3 ,

-.Xr wcsrtombs 3
+.Xr wcsrtombs 3 ,
+.Xr xlocale 3

 .Sh STANDARDS
 The
 .Fn mbsinit
 .Sh STANDARDS
 The
 .Fn mbsinit