Libc-1044.1.2.tar.gz

[apple/libc.git] / stdio / FreeBSD / fgetwln.3

diff --git a/stdio/FreeBSD/fgetwln.3 b/stdio/FreeBSD/fgetwln.3
index 5a8119c325167c124755364a5e833f473fc0ead9..c38fb39d59361bd209d47f3d6b19925ac937c796 100644 (file)
--- a/stdio/FreeBSD/fgetwln.3
+++ b/stdio/FreeBSD/fgetwln.3
@@ -32,7 +32,8 @@
 .Dt FGETWLN 3
 .Os
 .Sh NAME
 .Dt FGETWLN 3
 .Os
 .Sh NAME

-.Nm fgetwln
+.Nm fgetwln ,
+.Nm fgetwln_l

 .Nd get a line of wide characters from a stream
 .Sh LIBRARY
 .Lb libc
 .Nd get a line of wide characters from a stream
 .Sh LIBRARY
 .Lb libc


@@ -41,6 +42,9 @@
 .In wchar.h
 .Ft wchar_t *
 .Fn fgetwln "FILE * restrict stream" "size_t * restrict len"
 .In wchar.h
 .Ft wchar_t *
 .Fn fgetwln "FILE * restrict stream" "size_t * restrict len"

+.In xlocale.h
+.Ft wchar_t *
+.Fn fgetwln_l "FILE * restrict stream" "size_t * restrict len" "locale_t loc"

 .Sh DESCRIPTION
 The
 .Fn fgetwln
 .Sh DESCRIPTION
 The
 .Fn fgetwln


@@ -58,6 +62,14 @@ points.
 (Note, however, that if the line is the last
 in a file that does not end in a newline,
 the returned text will not contain a newline.)
 (Note, however, that if the line is the last
 in a file that does not end in a newline,
 the returned text will not contain a newline.)

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

 .Sh RETURN VALUES
 Upon successful completion a pointer is returned;
 this pointer becomes invalid after the next
 .Sh RETURN VALUES
 Upon successful completion a pointer is returned;
 this pointer becomes invalid after the next


@@ -113,4 +125,5 @@ or
 .Xr ferror 3 ,
 .Xr fgetln 3 ,
 .Xr fgetws 3 ,
 .Xr ferror 3 ,
 .Xr fgetln 3 ,
 .Xr fgetws 3 ,

-.Xr fopen 3
+.Xr fopen 3 ,
+.Xr xlocale 3