gl/xvasprintf.h

   1 /* vasprintf and asprintf with out-of-memory checking.
   2    Copyright (C) 2002-2004, 2006-2007 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
  38 extern "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.  */
  48 extern char *xasprintf (const char *format, ...)
  49        __attribute__ ((__format__ (__printf__, 1, 2)));
  50 extern 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 */