Sync usage with man page.
[netbsd-mini2440.git] / external / gpl2 / xcvs / dist / lib / vasprintf.c
blob149c29242cbb0fb25aaa10fc46964a512823feeb
1 /* Formatted output to strings.
2 Copyright (C) 1999, 2002 Free Software Foundation, Inc.
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2, or (at your option)
7 any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License along
15 with this program; if not, write to the Free Software Foundation,
16 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */
18 #ifdef HAVE_CONFIG_H
19 # include <config.h>
20 #endif
22 /* Specification. */
23 #include "vasprintf.h"
25 #include <stdlib.h>
27 #include "vasnprintf.h"
29 int
30 vasprintf (char **resultp, const char *format, va_list args)
32 size_t length;
33 char *result = vasnprintf (NULL, &length, format, args);
34 if (result == NULL)
35 return -1;
37 *resultp = result;
38 /* Return the number of resulting bytes, excluding the trailing NUL.
39 If it wouldn't fit in an 'int', vasnprintf() would have returned NULL
40 and set errno to EOVERFLOW. */
41 return length;