Add support for 'long double' number output.
[gnulib.git] / doc / functions / snprintf.texi
1 @node snprintf
2 @section @code{snprintf}
3 @findex snprintf
4
5 POSIX specification: @url{http://www.opengroup.org/susv3xsh/snprintf.html}
6
7 Gnulib module: snprintf or snprintf-posix
8
9 Portability problems fixed by either Gnulib module @code{snprintf} or @code{snprintf-posix}:
10 @itemize
11 @item
12 This function is missing on some platforms:
13 OSF/1 4.0, Solaris 2.5.1.
14 @end itemize
15
16 Portability problems fixed by Gnulib module @code{snprintf-posix}:
17 @itemize
18 @item
19 This function does not support size specifiers as in C99 (@code{hh}, @code{ll},
20 @code{j}, @code{t}, @code{z}) on some platforms:
21 AIX 5.1, HP-UX 11.23, IRIX 6.5, OSF/1 5.1, Solaris 9, Cygwin 2006, mingw, BeOS.
22 @item
23 printf of @samp{long double} numbers is unsupported on some platforms:
24 mingw, BeOS.
25 @item
26 This function does not support the @samp{a} and @samp{A} directives on some
27 platforms:
28 glibc-2.3.6, MacOS X 10.3, NetBSD 3.0, OpenBSD 4.0, AIX 5.2, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin, mingw, BeOS.
29 @item
30 This function does not support the @samp{F} directive on some platforms:
31 NetBSD 3.0, AIX 5.1, HP-UX 11.23, IRIX 6.5, OSF/1 5.1, Solaris 9, Cygwin, mingw, BeOS.
32 @item
33 This function does not support format directives that access arguments in an
34 arbitrary order, such as @code{"%2$s"}, on some platforms:
35 NetBSD 3.0, mingw, BeOS.
36 @item
37 This function doesn't support the @code{'} flag on some platforms:
38 NetBSD 3.0, Cygwin 2006, mingw.
39 @item
40 printf @code{"%010f"} of NaN and Infinity yields an incorrect result (padded
41 with zeroes) on some platforms:
42 MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, AIX 5.2, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 2007, mingw.
43 @item
44 This function does not truncate the result as specified in C99 on some platforms:
45 mingw.
46 @item
47 This function does not return a byte count as specified in C99 on some platforms:
48 HP-UX 11, IRIX 6.5, OSF/1 5.1, mingw.
49 @item
50 This function does not fully support the @samp{n} directive on some platforms:
51 HP-UX 11, mingw.
52 @item
53 This function overwrites memory even when a zero size argument is passed on some
54 platforms:
55 OSF/1 5.1.
56 @end itemize
57
58 Portability problems not fixed by Gnulib:
59 @itemize
60 @end itemize