| [10] | 1 | /* memory allocation routines with error checking.
|
|---|
| 2 | Copyright 1989, 90, 91, 92, 93, 94 Free Software Foundation, Inc.
|
|---|
| 3 |
|
|---|
| 4 | This file is part of the libiberty library.
|
|---|
| 5 | Libiberty is free software; you can redistribute it and/or
|
|---|
| 6 | modify it under the terms of the GNU Library General Public
|
|---|
| 7 | License as published by the Free Software Foundation; either
|
|---|
| 8 | version 2 of the License, or (at your option) any later version.
|
|---|
| 9 |
|
|---|
| 10 | Libiberty 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 GNU
|
|---|
| 13 | Library General Public License for more details.
|
|---|
| 14 |
|
|---|
| 15 | You should have received a copy of the GNU Library General Public
|
|---|
| 16 | License along with libiberty; see the file COPYING.LIB. If
|
|---|
| 17 | not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|---|
| 18 | Boston, MA 02111-1307, USA. */
|
|---|
| 19 |
|
|---|
| [609] | 20 | /*
|
|---|
| 21 |
|
|---|
| 22 | @deftypefn Replacement void* xmalloc (size_t)
|
|---|
| 23 |
|
|---|
| 24 | Allocate memory without fail. If @code{malloc} fails, this will print
|
|---|
| 25 | a message to @code{stderr} (using the name set by
|
|---|
| 26 | @code{xmalloc_set_program_name},
|
|---|
| 27 | if any) and then call @code{xexit}. Note that it is therefore safe for
|
|---|
| 28 | a program to contain @code{#define malloc xmalloc} in its source.
|
|---|
| 29 |
|
|---|
| 30 | @end deftypefn
|
|---|
| 31 |
|
|---|
| 32 | @deftypefn Replacement void* xrealloc (void *@var{ptr}, size_t @var{size})
|
|---|
| 33 | Reallocate memory without fail. This routine functions like @code{realloc},
|
|---|
| 34 | but will behave the same as @code{xmalloc} if memory cannot be found.
|
|---|
| 35 |
|
|---|
| 36 | @end deftypefn
|
|---|
| 37 |
|
|---|
| 38 | @deftypefn Replacement void* xcalloc (size_t @var{nelem}, size_t @var{elsize})
|
|---|
| 39 |
|
|---|
| 40 | Allocate memory without fail, and set it to zero. This routine functions
|
|---|
| 41 | like @code{calloc}, but will behave the same as @code{xmalloc} if memory
|
|---|
| 42 | cannot be found.
|
|---|
| 43 |
|
|---|
| 44 | @end deftypefn
|
|---|
| 45 |
|
|---|
| 46 | @deftypefn Replacement void xmalloc_set_program_name (const char *@var{name})
|
|---|
| 47 |
|
|---|
| 48 | You can use this to set the name of the program used by
|
|---|
| 49 | @code{xmalloc_failed} when printing a failure message.
|
|---|
| 50 |
|
|---|
| 51 | @end deftypefn
|
|---|
| 52 |
|
|---|
| 53 | @deftypefn Replacement void xmalloc_failed (size_t)
|
|---|
| 54 |
|
|---|
| 55 | This function is not meant to be called by client code, and is listed
|
|---|
| 56 | here for completeness only. If any of the allocation routines fail, this
|
|---|
| |
|---|
