Sync usage with man page.
[netbsd-mini2440.git] / gnu / dist / gettext / gettext-tools / lib / xallocsa.h
blobe938a6ea1dcf3603472c22fcd0db2e67019e91cb
1 /* Safe automatic memory allocation with out of memory checking.
2 Copyright (C) 2003, 2005 Free Software Foundation, Inc.
3 Written by Bruno Haible <bruno@clisp.org>, 2003.
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 2, or (at your option)
8 any later version.
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.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software Foundation,
17 Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
19 #ifndef _XALLOCSA_H
20 #define _XALLOCSA_H
22 #include "allocsa.h"
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
30 /* xallocsa(N) is a checking safe variant of alloca(N). It allocates N bytes
31 of memory allocated on the stack, that must be freed using freesa() before
32 the function returns. Upon failure, it exits with an error message. */
33 #if HAVE_ALLOCA
34 # define xallocsa(N) \
35 ((N) < 4032 - sa_increment \
36 ? (void *) ((char *) alloca ((N) + sa_increment) + sa_increment) \
37 : xmallocsa (N))
38 extern void * xmallocsa (size_t n);
39 #else
40 # define xallocsa(N) \
41 xmalloc (N)
42 #endif
44 /* Maybe we should also define a variant
45 xnallocsa (size_t n, size_t s) - behaves like xallocsa (n * s)
46 If this would be useful in your application. please speak up. */
49 #ifdef __cplusplus
51 #endif
54 #endif /* _XALLOCSA_H */