chiark / gitweb /
e178853fd7e736cf7ff1ccdad18354e5bf7e85a7
[mLib] / alloc.c
1 /* -*-c-*-
2  *
3  * $Id: alloc.c,v 1.2 1999/05/05 18:50:31 mdw Exp $
4  *
5  * Memory allocation functions
6  *
7  * (c) 1998 Straylight/Edgeware
8  */
9
10 /*----- Licensing notice --------------------------------------------------* 
11  *
12  * This file is part of the mLib utilities library.
13  *
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.
18  * 
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.
23  * 
24  * You should have received a copy of the GNU Library General Public
25  * License along with mLib; if not, write to the Free Software
26  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
27  */
28
29 /*----- Revision history --------------------------------------------------*
30  *
31  * $Log: alloc.c,v $
32  * Revision 1.2  1999/05/05 18:50:31  mdw
33  * Change licensing conditions to LGPL.
34  *
35  * Revision 1.1.1.1  1998/06/17 23:44:42  mdw
36  * Initial version of mLib
37  *
38  */
39
40 /*----- Header files ------------------------------------------------------*/
41
42 /* --- ANSI headers --- */
43
44 #include <stdio.h>
45 #include <stdlib.h>
46 #include <string.h>
47
48 /* --- Local headers --- */
49
50 #include "alloc.h"
51 #include "exc.h"
52 #include "track.h"
53
54 /*----- Functions provided ------------------------------------------------*/
55
56 /* --- @xmalloc@ --- *
57  *
58  * Arguments:   @size_t sz@ = size of block to allocate
59  *
60  * Returns:     Pointer to allocated block.
61  *
62  * Use:         Allocates memory.  If there's not enough memory, the
63  *              exception @EXC_NOMEM@ is thrown.
64  */
65
66 void *xmalloc(size_t sz)
67 {
68   void *p = malloc(sz);
69   if (!p)
70     THROW(EXC_NOMEM);
71   return (p);
72 }
73
74 /* --- @xstrdup@ --- *
75  *
76  * Arguments:   @const char *s@ = pointer to a string
77  *
78  * Returns:     Pointer to a copy of the string.
79  *
80  * Use:         Copies a string (like @strdup@ would, if it existed).  If
81  *              there's not enough memory, the exception @EXC_NOMEM@ is
82  *              thrown.
83  */
84
85 char *xstrdup(const char *s)
86 {
87   size_t sz = strlen(s) + 1;
88   char *p = xmalloc(sz);
89   memcpy(p, s, sz);
90   return (p);
91 }
92
93 /* --- @xrealloc@ --- *
94  *
95  * Arguments:   @void *p@ = pointer to a block of memory
96  *              @size_t sz@ = new size desired for the block
97  *
98  * Returns:     Pointer to the resized memory block (which is almost
99  *              certainly not in the same place any more).
100  *
101  * Use:         Resizes a memory block.  If there's not enough memory, the
102  *              exception @EXC_NOMEM@ is thrown.
103  */
104
105 void *xrealloc(void *p, size_t sz)
106 {
107   p = realloc(p, sz);
108   if (!p)
109     THROW(EXC_NOMEM);
110   return (p);
111 }
112
113 /*----- That's all, folks -------------------------------------------------*/