dbus-1.0/dbus/dbus-memory.h

0001 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
0002 /* dbus-memory.h  D-Bus memory handling
0003  *
0004  * Copyright (C) 2002  Red Hat Inc.
0005  *
0006  * Licensed under the Academic Free License version 2.1
0007  *
0008  * This program is free software; you can redistribute it and/or modify
0009  * it under the terms of the GNU General Public License as published by
0010  * the Free Software Foundation; either version 2 of the License, or
0011  * (at your option) any later version.
0012  *
0013  * This program is distributed in the hope that it will be useful,
0014  * but WITHOUT ANY WARRANTY; without even the implied warranty of
0015  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
0016  * GNU General Public License for more details.
0017  *
0018  * You should have received a copy of the GNU General Public License
0019  * along with this program; if not, write to the Free Software
0020  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
0021  *
0022  */
0023 #if !defined (DBUS_INSIDE_DBUS_H) && !defined (DBUS_COMPILATION)
0024 #error "Only <dbus/dbus.h> can be included directly, this file may disappear or change contents."
0025 #endif
0026
0027 #ifndef DBUS_MEMORY_H
0028 #define DBUS_MEMORY_H
0029
0030 #include <dbus/dbus-macros.h>
0031 #include <stddef.h>
0032
0033 DBUS_BEGIN_DECLS
0034
0035 /**
0036  * @addtogroup DBusMemory
0037  * @{
0038  */
0039
0040 DBUS_EXPORT
0041 DBUS_MALLOC
0042 DBUS_ALLOC_SIZE(1)
0043 void* dbus_malloc        (size_t bytes);
0044
0045 DBUS_EXPORT
0046 DBUS_MALLOC
0047 DBUS_ALLOC_SIZE(1)
0048 void* dbus_malloc0       (size_t bytes);
0049
0050 DBUS_EXPORT
0051 DBUS_ALLOC_SIZE(2)
0052 void* dbus_realloc       (void  *memory,
0053                           size_t bytes);
0054 DBUS_EXPORT
0055 void  dbus_free          (void  *memory);
0056
0057 #define dbus_new(type, count)  ((type*)dbus_malloc (sizeof (type) * (count)))
0058 #define dbus_new0(type, count) ((type*)dbus_malloc0 (sizeof (type) * (count)))
0059
0060 DBUS_EXPORT
0061 void dbus_free_string_array (char **str_array);
0062
0063 typedef void (* DBusFreeFunction) (void *memory);
0064
0065 DBUS_EXPORT
0066 void dbus_shutdown (void);
0067
0068 /** @} */
0069
0070 DBUS_END_DECLS
0071
0072 #endif /* DBUS_MEMORY_H */