fchmod-tests, fchmodat tests, lchmod tests: Add more tests.
[gnulib.git] / doc / glibc-functions / vasprintf.texi
blob441e594d8e883ed9fc5eea3089371023e049b71b
1 @node vasprintf
2 @subsection @code{vasprintf}
3 @findex vasprintf
5 LSB specification:@* @url{https://refspecs.linuxbase.org/LSB_5.0.0/LSB-Core-generic/LSB-Core-generic/baselib-vasprintf.html}
7 Documentation:
8 @itemize
9 @item
10 @ifinfo
11 @ref{Variable Arguments Output,,Variable Arguments Output Functions,libc},
12 @end ifinfo
13 @ifnotinfo
14 @url{https://www.gnu.org/software/libc/manual/html_node/Variable-Arguments-Output.html},
15 @end ifnotinfo
16 @item
17 @uref{https://www.kernel.org/doc/man-pages/online/pages/man3/vasprintf.3.html,,man vasprintf}.
18 @end itemize
20 Gnulib module: vasprintf or vasprintf-posix
22 Portability problems fixed by either Gnulib module @code{vasprintf} or @code{vasprintf-posix}:
23 @itemize
24 @item
25 This function is missing on some platforms:
26 AIX 5.1, HP-UX 11, IRIX 6.5, Solaris 10, mingw, MSVC 14.
27 @end itemize
29 Portability problems fixed by Gnulib module @code{vasprintf-posix}:
30 @itemize
31 @item
32 This function does not support size specifiers as in C99 (@code{hh}, @code{ll},
33 @code{j}, @code{t}, @code{z}) on some platforms:
34 Cygwin 1.5.24.
35 @item
36 printf @code{"%f"}, @code{"%e"}, @code{"%g"} of Infinity and NaN yields an
37 incorrect result on some platforms:
38 Solaris 11.0.
39 @item
40 This function does not support the @samp{a} and @samp{A} directives on some
41 platforms:
42 glibc-2.3.6, Mac OS X 10.5, NetBSD 9.0, OpenBSD 4.0, Solaris 11.4, Cygwin 1.5.x.
43 @item
44 This function does not support the @samp{F} directive on some platforms:
45 NetBSD 3.0, Cygwin 1.5.x.
46 @item
47 This function does not support the @samp{ls} directive on some platforms:
48 OpenBSD 4.0, Cygwin 1.5.x, Haiku.
49 @item
50 This function does not support precisions in the @samp{ls} directive correctly
51 on some platforms:
52 Solaris 11.4.
53 @item
54 This function does not support format directives that access arguments in an
55 arbitrary order, such as @code{"%2$s"}, on some platforms:
56 NetBSD 3.0.
57 @item
58 This function doesn't support the @code{'} flag on some platforms:
59 NetBSD 3.0, Cygwin 1.5.24.
60 @item
61 This function does not round the argument of the @samp{a} directive correctly
62 on some platforms:
63 Mac OS X 10.12, FreeBSD 6.1.
64 @item
65 printf @code{"%010f"} of NaN and Infinity yields an incorrect result (padded
66 with zeroes) on some platforms:
67 Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, Solaris 11.0, Cygwin 1.5.x.
68 @item
69 This function can crash in out-of-memory conditions on some platforms:
70 FreeBSD 6.0, NetBSD 5.0.
71 @end itemize
73 Portability problems not fixed by Gnulib:
74 @itemize
75 @item
76 The @code{%m} directive is not portable, use @code{%s} mapped to an
77 argument of @code{strerror(errno)} (or a version of @code{strerror_r})
78 instead.
79 @end itemize