source4/include/talloc.h

   1 #ifndef _TALLOC_H_
   2 #define _TALLOC_H_
   3 /*
   4    Unix SMB/CIFS implementation.
   5    Samba temporary memory allocation functions
   6    Copyright (C) Andrew Tridgell 2000
   7    Copyright (C) 2001 by Martin Pool <mbp@samba.org>
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 2 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program; if not, write to the Free Software
  21    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  22 */
  23
  24 /**
  25  * @ingroup talloc
  26  * @{
  27  * @sa talloc.c
  28  */
  29
  30 /**
  31  * talloc allocation pool.  All allocated blocks can be freed in one go.
  32  **/
  33 typedef struct talloc_ctx TALLOC_CTX;
  34
  35 TALLOC_CTX *talloc_init(char const *fmt, ...) PRINTF_ATTRIBUTE(1, 2);
  36
  37 char *talloc_vasprintf(TALLOC_CTX *t, const char *fmt, va_list ap)
  38         PRINTF_ATTRIBUTE(2, 0);
  39
  40 char *talloc_asprintf(TALLOC_CTX *t, const char *fmt, ...)
  41         PRINTF_ATTRIBUTE(2, 3);
  42
  43 char *talloc_vasprintf_append(TALLOC_CTX *t, char *, const char *, va_list ap)
  44         PRINTF_ATTRIBUTE(3, 0);
  45
  46 char *talloc_asprintf_append(TALLOC_CTX *t, char *, const char *, ...)
  47         PRINTF_ATTRIBUTE(3, 4);
  48
  49 /* useful macros for creating type checked pointers */
  50 #define talloc_p(ctx, type) (type *)talloc(ctx, sizeof(type));
  51 #define talloc_array_p(ctx, type, count) (type *)talloc_realloc_array(ctx, NULL, sizeof(type), count)
  52 #define talloc_realloc_p(ctx, p, type, count) (type *)talloc_realloc_array(ctx, p, sizeof(type), count)
  53
  54 #define malloc_p(type) (type *)malloc(sizeof(type))
  55 #define malloc_array_p(type, count) (type *)realloc_array(NULL, sizeof(type), count)
  56 #define realloc_p(p, type, count) (type *)realloc_array(p, sizeof(type), count)
  57
  58 /** @} */
  59
  60 #endif /* ndef _TALLOC_H_ */