Loading...
--- 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