Mercurial > gnulib

annotate lib/c-xvasprintf.h @ 40203:30d91797009f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
autoupdate
author Karl Berry <karl@freefriends.org>
date Fri, 01 Mar 2019 08:42:42 -0800
parents b06060465f09
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
17212
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
1 /* vasprintf and asprintf, with out-of-memory checking, in C locale.
40057
b06060465f09 maint: Run 'make update-copyright'
Paul Eggert <eggert@cs.ucla.edu>
parents: 19484
diff changeset
2 Copyright (C) 2002-2004, 2006-2019 Free Software Foundation, Inc.
17212
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
3
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
4 This program is free software: you can redistribute it and/or modify
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
5 it under the terms of the GNU General Public License as published by
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
6 the Free Software Foundation; either version 3 of the License, or
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
7 (at your option) any later version.
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
8
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
9 This program is distributed in the hope that it will be useful,
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
12 GNU General Public License for more details.
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
13
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
14 You should have received a copy of the GNU General Public License
19190
9759915b2aca all: prefer https: URLs
Paul Eggert <eggert@cs.ucla.edu>
parents: 18626
diff changeset
15 along with this program. If not, see <https://www.gnu.org/licenses/>. */
17212
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
16
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
17 #ifndef _C_XVASPRINTF_H
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
18 #define _C_XVASPRINTF_H
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
19
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
20 /* Get va_list. */
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
21 #include <stdarg.h>
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
22
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
23 /* The __attribute__ feature is available in gcc versions 2.5 and later.
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
24 The __-protected variants of the attributes 'format' and 'printf' are
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
25 accepted by gcc versions 2.6.4 (effectively 2.7) and later.
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
26 We enable _GL_ATTRIBUTE_FORMAT only if these are supported too, because
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
27 gnulib and libintl do '#define printf __printf__' when they override
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
28 the 'printf' function. */
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
29 #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7)
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
30 # define _GL_ATTRIBUTE_FORMAT(spec) __attribute__ ((__format__ spec))
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
31 #else
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
32 # define _GL_ATTRIBUTE_FORMAT(spec) /* empty */
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
33 #endif
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
34
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
35 #ifdef __cplusplus
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
36 extern "C" {
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
37 #endif
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
38
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
39 /* Write formatted output to a string dynamically allocated with malloc(),
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
40 and return it. Upon [ENOMEM] memory allocation error, call xalloc_die.
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
41 On some other error
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
42 - [EOVERFLOW] resulting string length is > INT_MAX,
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
43 - [EINVAL] invalid format string,
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
44 - [EILSEQ] error during conversion between wide and multibyte characters,
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
45 return NULL.
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
46
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
47 Formatting takes place in the C locale, that is, the decimal point
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
48 used in floating-point formatting directives is always '.'. */
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
49 extern char *c_xasprintf (const char *format, ...)
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
50 _GL_ATTRIBUTE_FORMAT ((__printf__, 1, 2));
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
51 extern char *c_xvasprintf (const char *format, va_list args)
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
52 _GL_ATTRIBUTE_FORMAT ((__printf__, 1, 0));
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
53
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
54 #ifdef __cplusplus
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
55 }
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
56 #endif
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
57
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
58 #endif /* _C_XVASPRINTF_H */