3 * $Id: sub.h,v 1.4 1999/05/13 22:48:55 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.4 1999/05/13 22:48:55 mdw
34 * Change `-ise' to `-ize' throughout.
36 * Revision 1.3 1999/05/06 19:51:35 mdw
37 * Reformatted the LGPL notice a little bit.
39 * Revision 1.2 1999/05/05 18:50:31 mdw
40 * Change licensing conditions to LGPL.
42 * Revision 1.1.1.1 1998/06/17 23:44:42 mdw
43 * Initial version of mLib
54 /*----- Required header files ---------------------------------------------*/
62 /*----- Functions provided ------------------------------------------------*/
64 /* --- @sub_alloc@ --- *
66 * Arguments: @size_t s@ = size of chunk wanted
68 * Returns: Pointer to a block at least as large as the one wanted.
70 * Use: Allocates a small block of memory. If there is no more
71 * memory left, the exception @EXC_NOMEM@ is raised.
75 # define sub_alloc(s) xmalloc(s)
77 void *sub_alloc(size_t s);
80 /* --- @sub_free@ --- *
82 * Arguments: @void *p@ = address of block to free
83 * @size_t s@ = size of block
87 * Use: Frees a block allocated by @sub_alloc@.
91 # define sub_free(p, s) free(p)
93 void sub_free(void *p, size_t s);
98 * Arguments: @type@ = type of object required; must be passable to
101 * Returns: Pointer to a block sufficiently big to hold an object of the
104 * Use: Allocates a block of the required type.
107 #define CREATE(type) sub_alloc(sizeof(type))
109 /* --- @DESTROY@ --- *
111 * Arguments: @void *p@ = pointer to an object
115 * Use: Frees the thing pointed to by @p@.
118 #define DESTROY(p) sub_free(p, sizeof(*p))
120 /* --- @sub_init@ --- *
126 * Use: Initializes the magic allocator.
131 /*----- That's all, folks -------------------------------------------------*/