1/* vasprintf and asprintf with out-of-memory checking.
2   Copyright (C) 2002-2004, 2006 Free Software Foundation, Inc.
3
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.
8
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.
13
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.  */
17
18#ifndef _XVASPRINTF_H
19#define _XVASPRINTF_H
20
21/* Get va_list.  */
22#include <stdarg.h>
23
24#ifndef __attribute__
25/* This feature is available in gcc versions 2.5 and later.  */
26# if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 5) || __STRICT_ANSI__
27#  define __attribute__(Spec) /* empty */
28# endif
29/* The __-protected variants of `format' and `printf' attributes
30   are accepted by gcc versions 2.6.4 (effectively 2.7) and later.  */
31# if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 7)
32#  define __format__ format
33#  define __printf__ printf
34# endif
35#endif
36
37#ifdef	__cplusplus
38extern "C" {
39#endif
40
41/* Write formatted output to a string dynamically allocated with malloc(),
42   and return it.  Upon [ENOMEM] memory allocation error, call xalloc_die.
43   On some other error
44     - [EOVERFLOW] resulting string length is > INT_MAX,
45     - [EINVAL] invalid format string,
46     - [EILSEQ] error during conversion between wide and multibyte characters,
47   return NULL.  */
48extern char *xasprintf (const char *format, ...)
49       __attribute__ ((__format__ (__printf__, 1, 2)));
50extern char *xvasprintf (const char *format, va_list args)
51       __attribute__ ((__format__ (__printf__, 1, 0)));
52
53#ifdef	__cplusplus
54}
55#endif
56
57#endif /* _XVASPRINTF_H */
58