--- wprintf.3.bsdnew 2009-11-11 13:33:22.000000000 -0800 +++ wprintf.3 2009-11-11 13:33:22.000000000 -0800 @@ -37,8 +37,12 @@ .Dt WPRINTF 3 .Os .Sh NAME -.Nm wprintf , fwprintf , swprintf , -.Nm vwprintf , vfwprintf , vswprintf +.Nm fwprintf , +.Nm swprintf , +.Nm vfwprintf , +.Nm vswprintf , +.Nm vwprintf , +.Nm wprintf .Nd formatted wide character output conversion .Sh LIBRARY .Lb libc @@ -46,23 +50,49 @@ .In stdio.h .In wchar.h .Ft int -.Fn fwprintf "FILE * restrict stream" "const wchar_t * restrict format" ... +.Fo fwprintf +.Fa "FILE *restrict stream" +.Fa "const wchar_t *restrict format" +.Fa ... +.Fc .Ft int -.Fn swprintf "wchar_t * restrict ws" "size_t n" "const wchar_t * restrict format" ... +.Fo swprintf +.Fa "wchar_t *restrict ws" +.Fa "size_t n" +.Fa "const wchar_t *restrict format" +.Fa ... +.Fc .Ft int -.Fn wprintf "const wchar_t * restrict format" ... +.Fo wprintf +.Fa "const wchar_t *restrict format" +.Fa ... +.Fc .In stdarg.h +.In stdio.h +.In wchar.h .Ft int -.Fn vfwprintf "FILE * restrict stream" "const wchar_t * restrict" "va_list ap" +.Fo vfwprintf +.Fa "FILE *restrict stream" +.Fa "const wchar_t *restrict format" +.Fa "va_list arg" +.Fc .Ft int -.Fn vswprintf "wchar_t * restrict ws" "size_t n" "const wchar_t *restrict format" "va_list ap" +.Fo vswprintf +.Fa "wchar_t *restrict ws" +.Fa "size_t n" +.Fa "const wchar_t *restrict format" +.Fa "va_list arg" +.Fc .Ft int -.Fn vwprintf "const wchar_t * restrict format" "va_list ap" +.Fo vwprintf +.Fa "const wchar_t *restrict format" +.Fa "va_list arg" +.Fc .Sh DESCRIPTION The .Fn wprintf family of functions produces output according to a -.Fa format +.Fa format , as described below. The .Fn wprintf @@ -83,6 +113,12 @@ and write to the wide character string .Fa ws . .Pp +Extended locale versions of these functions are documented in +.Xr wprintf_l 3 . +See +.Xr xlocale 3 +for more information. +.Pp These functions write the output under the control of a .Fa format string that specifies how subsequent arguments @@ -92,7 +128,7 @@ are converted for output. .Pp These functions return the number of characters printed (not including the trailing -.Ql \e0 +.Ql \e0 , used to end output to strings). .Pp The @@ -598,6 +634,7 @@ Refer to .Xr putwc 3 , .Xr setlocale 3 , .Xr wcsrtombs 3 , +.Xr wprintf_l 3 , .Xr wscanf 3 .Sh STANDARDS Subject to the caveats noted in the @@ -610,7 +647,7 @@ the .Fn fwprintf , .Fn swprintf , .Fn vwprintf , -.Fn vfwprintf +.Fn vfwprintf , and .Fn vswprintf functions