2015-08-24 François Dumont <fdumont@gcc.gnu.org>
[official-gcc.git] / libiberty / asprintf.c
blob961ad4dbb002edad88b4feb3a53eb73f8ca14800
1 /* Like sprintf but provides a pointer to malloc'd storage, which must
2 be freed by the caller.
3 Copyright (C) 1997, 2003, 2013 Free Software Foundation, Inc.
4 Contributed by Cygnus Solutions.
6 This file is part of the libiberty library.
7 Libiberty is free software; you can redistribute it and/or
8 modify it under the terms of the GNU Library General Public
9 License as published by the Free Software Foundation; either
10 version 2 of the License, or (at your option) any later version.
12 Libiberty is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 Library General Public License for more details.
17 You should have received a copy of the GNU Library General Public
18 License along with libiberty; see the file COPYING.LIB. If
19 not, write to the Free Software Foundation, Inc., 51 Franklin Street - Fifth Floor,
20 Boston, MA 02110-1301, USA. */
22 #ifdef HAVE_CONFIG_H
23 #include "config.h"
24 #endif
25 #include "ansidecl.h"
26 #include "libiberty.h"
28 #include <stdarg.h>
32 @deftypefn Extension int asprintf (char **@var{resptr}, const char *@var{format}, ...)
34 Like @code{sprintf}, but instead of passing a pointer to a buffer, you
35 pass a pointer to a pointer. This function will compute the size of
36 the buffer needed, allocate memory with @code{malloc}, and store a
37 pointer to the allocated memory in @code{*@var{resptr}}. The value
38 returned is the same as @code{sprintf} would return. If memory could
39 not be allocated, minus one is returned and @code{NULL} is stored in
40 @code{*@var{resptr}}.
42 @end deftypefn
46 int
47 asprintf (char **buf, const char *fmt, ...)
49 int status;
50 va_list ap;
51 va_start (ap, fmt);
52 status = vasprintf (buf, fmt, ap);
53 va_end (ap);
54 return status;