Loading...
stdio/FreeBSD/wprintf.3 Libc-1725.40.4 Libc-825.26
--- Libc/Libc-1725.40.4/stdio/FreeBSD/wprintf.3
+++ Libc/Libc-825.26/stdio/FreeBSD/wprintf.3
@@ -31,14 +31,18 @@
 .\"
 .\"     @(#)printf.3	8.1 (Berkeley) 6/4/93
 .\" FreeBSD: src/lib/libc/stdio/printf.3,v 1.47 2002/09/06 11:23:55 tjr Exp
-.\" $FreeBSD$
+.\" $FreeBSD: src/lib/libc/stdio/wprintf.3,v 1.6 2007/01/09 00:28:08 imp Exp $
 .\"
 .Dd July 5, 2003
 .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
@@ -105,18 +135,9 @@
 .Fn swprintf
 and
 .Fn vswprintf
-functions return the number of characters written (not including the terminating
-null wide character).
-These functions will fail (returning a negative value and setting
-.Va errno
-appropriately) if
+functions will fail if
 .Fa n
-or more wide characters were requested to be written.
-.Pp
-The other functions return the number of wide characters printed on success, or
-a negative value on faiure, setting
-.Va errno
-to indicate the error.
+or more wide characters were requested to be written,
 .Pp
 The format string is composed of zero or more directives:
 ordinary
@@ -391,7 +412,7 @@
 .Vt double
 argument is rounded and converted in the style
 .Sm off
-.Oo \- Oc Ar d Li \&. Ar ddd Li e \(+- Ar dd
+.Oo \- Oc Ar d Li \&. Ar ddd Li e \\*[Pm] Ar dd
 .Sm on
 where there is one digit before the
 decimal-point character
@@ -467,7 +488,7 @@
 .Vt double
 argument is converted to hexadecimal notation in the style
 .Sm off
-.Oo \- Oc Li 0x Ar h Li \&. Ar hhhp Oo \(+- Oc Ar d ,
+.Oo \- Oc Li 0x Ar h Li \&. Ar hhhp Oo \\*[Pm] Oc Ar d ,
 .Sm on
 where the number of digits after the hexadecimal-point character
 is equal to the precision specification.
@@ -604,9 +625,6 @@
 width, the
 field is expanded to contain the conversion result.
 .Sh SECURITY CONSIDERATIONS
-Refer to
-.Xr printf 3 .
-.Sh ERRORS
 Refer to
 .Xr printf 3 .
 .Sh SEE ALSO
@@ -629,7 +647,7 @@
 .Fn fwprintf ,
 .Fn swprintf ,
 .Fn vwprintf ,
-.Fn vfwprintf
+.Fn vfwprintf ,
 and
 .Fn vswprintf
 functions