3 * $Id: sub.h,v 1.5 1999/12/10 23:42:04 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.5 1999/12/10 23:42:04 mdw
34 * Change header file guard names.
36 * Revision 1.4 1999/05/13 22:48:55 mdw
37 * Change `-ise' to `-ize' throughout.
39 * Revision 1.3 1999/05/06 19:51:35 mdw
40 * Reformatted the LGPL notice a little bit.
42 * Revision 1.2 1999/05/05 18:50:31 mdw
43 * Change licensing conditions to LGPL.
45 * Revision 1.1.1.1 1998/06/17 23:44:42 mdw
46 * Initial version of mLib
57 /*----- Required header files ---------------------------------------------*/
65 /*----- Functions provided ------------------------------------------------*/
67 /* --- @sub_alloc@ --- *
69 * Arguments: @size_t s@ = size of chunk wanted
71 * Returns: Pointer to a block at least as large as the one wanted.
73 * Use: Allocates a small block of memory. If there is no more
74 * memory left, the exception @EXC_NOMEM@ is raised.
78 # define sub_alloc(s) xmalloc(s)
80 void *sub_alloc(size_t s);
83 /* --- @sub_free@ --- *
85 * Arguments: @void *p@ = address of block to free
86 * @size_t s@ = size of block
90 * Use: Frees a block allocated by @sub_alloc@.
94 # define sub_free(p, s) free(p)
96 void sub_free(void *p, size_t s);
101 * Arguments: @type@ = type of object required; must be passable to
104 * Returns: Pointer to a block sufficiently big to hold an object of the
107 * Use: Allocates a block of the required type.
110 #define CREATE(type) sub_alloc(sizeof(type))
112 /* --- @DESTROY@ --- *
114 * Arguments: @void *p@ = pointer to an object
118 * Use: Frees the thing pointed to by @p@.
121 #define DESTROY(p) sub_free(p, sizeof(*p))
123 /* --- @sub_init@ --- *
129 * Use: Initializes the magic allocator.
134 /*----- That's all, folks -------------------------------------------------*/