--- wprintf.3.orig 2007-04-08 18:49:37.000000000 -0700 +++ wprintf.3 2007-04-08 20:12:12.000000000 -0700 @@ -41,8 +41,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 @@ -50,23 +54,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 @@ -87,6 +117,12 @@ 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 @@ -96,7 +132,7 @@ .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 @@ -602,6 +638,7 @@ .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 @@ -614,7 +651,7 @@ .Fn fwprintf , .Fn swprintf , .Fn vwprintf , -.Fn vfwprintf +.Fn vfwprintf , and .Fn vswprintf functions