3 * $Id: sub.h,v 1.3 1999/05/06 19:51:35 mdw Exp $
5 * Allocation of known-size blocks
7 * (c) 1998 Straylight/Edgeware
10 /*----- Licensing notice --------------------------------------------------*
12 * This file is part of the mLib utilities library.
14 * mLib is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU Library General Public License as
16 * published by the Free Software Foundation; either version 2 of the
17 * License, or (at your option) any later version.
19 * mLib is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU Library General Public License for more details.
24 * You should have received a copy of the GNU Library General Public
25 * License along with mLib; if not, write to the Free
26 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
30 /*----- Revision history --------------------------------------------------*
33 * Revision 1.3 1999/05/06 19:51:35 mdw
34 * Reformatted the LGPL notice a little bit.
36 * Revision 1.2 1999/05/05 18:50:31 mdw
37 * Change licensing conditions to LGPL.
39 * Revision 1.1.1.1 1998/06/17 23:44:42 mdw
40 * Initial version of mLib
51 /*----- Required header files ---------------------------------------------*/
59 /*----- Functions provided ------------------------------------------------*/
61 /* --- @sub_alloc@ --- *
63 * Arguments: @size_t s@ = size of chunk wanted
65 * Returns: Pointer to a block at least as large as the one wanted.
67 * Use: Allocates a small block of memory. If there is no more
68 * memory left, the exception @EXC_NOMEM@ is raised.
72 # define sub_alloc(s) xmalloc(s)
74 void *sub_alloc(size_t s);
77 /* --- @sub_free@ --- *
79 * Arguments: @void *p@ = address of block to free
80 * @size_t s@ = size of block
84 * Use: Frees a block allocated by @sub_alloc@.
88 # define sub_free(p, s) free(p)
90 void sub_free(void *p, size_t s);
95 * Arguments: @type@ = type of object required; must be passable to
98 * Returns: Pointer to a block sufficiently big to hold an object of the
101 * Use: Allocates a block of the required type.
104 #define CREATE(type) sub_alloc(sizeof(type))
106 /* --- @DESTROY@ --- *
108 * Arguments: @void *p@ = pointer to an object
112 * Use: Frees the thing pointed to by @p@.
115 #define DESTROY(p) sub_free(p, sizeof(*p))
117 /* --- @sub_init@ --- *
123 * Use: Initialises the magic allocator.
128 /*----- That's all, folks -------------------------------------------------*/