--- fgetwln.3.orig 2009-10-29 11:41:29.000000000 -0700 +++ fgetwln.3 2009-10-29 11:44:37.000000000 -0700 @@ -32,7 +32,8 @@ .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 @@ -41,6 +42,9 @@ .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 @@ -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.) +.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 @@ -113,4 +125,5 @@ or .Xr ferror 3 , .Xr fgetln 3 , .Xr fgetws 3 , -.Xr fopen 3 +.Xr fopen 3 , +.Xr xlocale 3