Annotation of embedaddon/libiconv/srclib/xalloc.h, revision 1.1.1.2
1.1 misho 1: /* malloc with out of memory checking.
2: Copyright (C) 2001-2004, 2006 Free Software Foundation, Inc.
3: Written by Bruno Haible <haible@clisp.cons.org>, 2001.
4:
5: This program is free software: you can redistribute it and/or modify
6: it under the terms of the GNU General Public License as published by
7: the Free Software Foundation; either version 3 of the License, or
8: (at your option) any later version.
9:
10: This program is distributed in the hope that it will be useful,
11: but WITHOUT ANY WARRANTY; without even the implied warranty of
12: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13: GNU General Public License for more details.
14:
15: You should have received a copy of the GNU General Public License
16: along with this program. If not, see <http://www.gnu.org/licenses/>. */
17:
18: #ifndef _XALLOC_H
19: #define _XALLOC_H
20:
21: #include <stddef.h>
22:
23:
24: #ifdef __cplusplus
25: extern "C" {
26: #endif
27:
28:
29: /* Defined in xmalloc.c. */
30:
31: /* Allocate SIZE bytes of memory dynamically, with error checking. */
32: extern void *xmalloc (size_t size);
33:
34: /* Allocate memory for NMEMB elements of SIZE bytes, with error checking.
35: SIZE must be > 0. */
36: extern void *xnmalloc (size_t nmemb, size_t size);
37:
38: /* Allocate SIZE bytes of memory dynamically, with error checking,
39: and zero it. */
40: extern void *xzalloc (size_t size);
41:
42: /* Allocate memory for NMEMB elements of SIZE bytes, with error checking,
43: and zero it. */
44: extern void *xcalloc (size_t nmemb, size_t size);
45:
46: /* Change the size of an allocated block of memory PTR to SIZE bytes,
47: with error checking. If PTR is NULL, run xmalloc. */
48: extern void *xrealloc (void *ptr, size_t size);
49: #ifdef __cplusplus
50: }
51: template <typename T>
52: inline T * xrealloc (T * ptr, size_t size)
53: {
54: return (T *) xrealloc ((void *) ptr, size);
55: }
56: extern "C" {
57: #endif
58:
59: /* This function is always triggered when memory is exhausted. It is
60: in charge of honoring the three previous items. This is the
61: function to call when one wants the program to die because of a
62: memory allocation failure. */
63: extern void xalloc_die (void)
64: #if (__GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 5)) && !__STRICT_ANSI__
65: __attribute__ ((__noreturn__))
66: #endif
67: ;
68:
69: /* In the following macros, T must be an elementary or structure/union or
70: typedef'ed type, or a pointer to such a type. To apply one of the
71: following macros to a function pointer or array type, you need to typedef
72: it first and use the typedef name. */
73:
74: /* Allocate an object of type T dynamically, with error checking. */
75: /* extern T *XMALLOC (typename T); */
76: #define XMALLOC(T) \
77: ((T *) xmalloc (sizeof (T)))
78:
79: /* Allocate memory for NMEMB elements of type T, with error checking. */
80: /* extern T *XNMALLOC (size_t nmemb, typename T); */
81: #if HAVE_INLINE
82: /* xnmalloc performs a division and multiplication by sizeof (T). Arrange to
83: perform the division at compile-time and the multiplication with a factor
84: known at compile-time. */
85: # define XNMALLOC(N,T) \
86: ((T *) (sizeof (T) == 1 \
1.1.1.2 ! misho 87: ? xmalloc (N) \
! 88: : xnboundedmalloc(N, (size_t) (sizeof (ptrdiff_t) <= sizeof (size_t) ? -1 : -2) / sizeof (T), sizeof (T))))
1.1 misho 89: static inline void *
90: xnboundedmalloc (size_t n, size_t bound, size_t s)
91: {
92: if (n > bound)
93: xalloc_die ();
94: return xmalloc (n * s);
95: }
96: #else
97: # define XNMALLOC(N,T) \
98: ((T *) (sizeof (T) == 1 ? xmalloc (N) : xnmalloc (N, sizeof (T))))
99: #endif
100:
101: /* Allocate an object of type T dynamically, with error checking,
102: and zero it. */
103: /* extern T *XZALLOC (typename T); */
104: #define XZALLOC(T) \
105: ((T *) xzalloc (sizeof (T)))
106:
107: /* Allocate memory for NMEMB elements of type T, with error checking,
108: and zero it. */
109: /* extern T *XCALLOC (size_t nmemb, typename T); */
110: #define XCALLOC(N,T) \
111: ((T *) xcalloc (N, sizeof (T)))
112:
113: /* Return a pointer to a new buffer of N bytes. This is like xmalloc,
114: except it returns char *. */
115: #define xcharalloc(N) \
116: XNMALLOC (N, char)
117:
118:
119: /* Defined in xstrdup.c. */
120:
121: /* Return a newly allocated copy of the N bytes of memory starting at P. */
122: extern void *xmemdup (const void *p, size_t n);
123: #ifdef __cplusplus
124: }
125: template <typename T>
126: inline T * xmemdup (const T * p, size_t n)
127: {
128: return (T *) xmemdup ((const void *) p, n);
129: }
130: extern "C" {
131: #endif
132:
133: /* Return a newly allocated copy of STRING. */
134: extern char *xstrdup (const char *string);
135:
136:
137: /* Return 1 if an array of N objects, each of size S, cannot exist due
138: to size arithmetic overflow. S must be positive and N must be
139: nonnegative. This is a macro, not an inline function, so that it
140: works correctly even when SIZE_MAX < N.
141:
142: By gnulib convention, SIZE_MAX represents overflow in size
143: calculations, so the conservative dividend to use here is
144: SIZE_MAX - 1, since SIZE_MAX might represent an overflowed value.
145: However, malloc (SIZE_MAX) fails on all known hosts where
146: sizeof (ptrdiff_t) <= sizeof (size_t), so do not bother to test for
147: exactly-SIZE_MAX allocations on such hosts; this avoids a test and
148: branch when S is known to be 1. */
149: # define xalloc_oversized(n, s) \
150: ((size_t) (sizeof (ptrdiff_t) <= sizeof (size_t) ? -1 : -2) / (s) < (n))
151:
152:
153: #ifdef __cplusplus
154: }
155: #endif
156:
157:
158: #endif /* _XALLOC_H */
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>