gitlog-to-changelog: Tweak documentation.
[gnulib.git] / lib / c-vasprintf.c
blob81d45ce0ace2b12b0aba0794281e41b84cbfc32d
1 /* Formatted output to strings in C locale.
2 Copyright (C) 1999, 2002, 2006-2024 Free Software Foundation, Inc.
4 This file is free software: you can redistribute it and/or modify
5 it under the terms of the GNU Lesser General Public License as
6 published by the Free Software Foundation; either version 2.1 of the
7 License, or (at your option) any later version.
9 This file 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 Lesser General Public License for more details.
14 You should have received a copy of the GNU Lesser General Public License
15 along with this program. If not, see <https://www.gnu.org/licenses/>. */
17 #include <config.h>
19 /* Specification. */
20 #include "c-vasprintf.h"
22 #include <errno.h>
23 #include <limits.h>
24 #include <stdint.h>
25 #include <stdlib.h>
27 #include "c-vasnprintf.h"
29 int
30 c_vasprintf (char **resultp, const char *format, va_list args)
32 size_t length;
33 char *result = c_vasnprintf (NULL, &length, format, args);
34 if (result == NULL)
35 return -1;
37 #if PTRDIFF_MAX > INT_MAX
38 if (length > INT_MAX)
40 free (result);
41 errno = (length > PTRDIFF_MAX ? ENOMEM : EOVERFLOW);
42 return -1;
44 #else
45 if (length > PTRDIFF_MAX)
47 free (result);
48 errno = ENOMEM;
49 return -1;
51 #endif
53 *resultp = result;
54 /* Return the number of resulting bytes, excluding the trailing NUL. */
55 return length;