contrib/cvs-1.12/lib/vasprintf.h

   1 /* vsprintf with automatic memory allocation.
   2    Copyright (C) 2002-2003 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 _VASPRINTF_H
  19 #define _VASPRINTF_H
  20
  21 #if HAVE_VASPRINTF
  22
  23 /* Get asprintf(), vasprintf() declarations.  */
  24 #include <stdio.h>
  25
  26 #else
  27
  28 /* Get va_list.  */
  29 #include <stdarg.h>
  30
  31 #ifndef __attribute__
  32 /* This feature is available in gcc versions 2.5 and later.  */
  33 # if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 5) || __STRICT_ANSI__
  34 #  define __attribute__(Spec) /* empty */
  35 # endif
  36 /* The __-protected variants of `format' and `printf' attributes
  37    are accepted by gcc versions 2.6.4 (effectively 2.7) and later.  */
  38 # if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 7)
  39 #  define __format__ format
  40 #  define __printf__ printf
  41 # endif
  42 #endif
  43
  44 #ifdef  __cplusplus
  45 extern "C" {
  46 #endif
  47
  48 /* Write formatted output to a string dynamically allocated with malloc().
  49    If the memory allocation succeeds, store the address of the string in
  50    *RESULT and return the number of resulting bytes, excluding the trailing
  51    NUL.  Upon memory allocation error, or some other error, return -1.  */
  52 extern int asprintf (char **result, const char *format, ...)
  53        __attribute__ ((__format__ (__printf__, 2, 3)));
  54 extern int vasprintf (char **result, const char *format, va_list args)
  55        __attribute__ ((__format__ (__printf__, 2, 0)));
  56
  57 #ifdef  __cplusplus
  58 }
  59 #endif
  60
  61 #endif
  62
  63 #endif /* _VASPRINTF_H */