| 1 | /* obstack.h,v 1.2 2004/09/14 22:27:34 bird Exp */
|
|---|
| 2 | /** @file
|
|---|
| 3 | * GNU, -liberty.
|
|---|
| 4 | */
|
|---|
| 5 |
|
|---|
| 6 | /* obstack.h - object stack macros
|
|---|
| 7 | Copyright 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1996, 1997, 1998,
|
|---|
| 8 | 1999, 2000
|
|---|
| 9 | Free Software Foundation, Inc.
|
|---|
| 10 |
|
|---|
| 11 |
|
|---|
| 12 | NOTE: The canonical source of this file is maintained with the GNU C Library.
|
|---|
| 13 | Bugs can be reported to [email protected].
|
|---|
| 14 |
|
|---|
| 15 | This program is free software; you can redistribute it and/or modify it
|
|---|
| 16 | under the terms of the GNU General Public License as published by the
|
|---|
| 17 | Free Software Foundation; either version 2, or (at your option) any
|
|---|
| 18 | later version.
|
|---|
| 19 |
|
|---|
| 20 | This program is distributed in the hope that it will be useful,
|
|---|
| 21 | but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|---|
| 22 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|---|
| 23 | GNU General Public License for more details.
|
|---|
| 24 |
|
|---|
| 25 | You should have received a copy of the GNU General Public License
|
|---|
| 26 | along with this program; if not, write to the Free Software
|
|---|
| 27 | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
|
|---|
| 28 | USA. */
|
|---|
| 29 |
|
|---|
| 30 | /* Summary:
|
|---|
| 31 |
|
|---|
| 32 | All the apparent functions defined here are macros. The idea
|
|---|
| 33 | is that you would use these pre-tested macros to solve a
|
|---|
| 34 | very specific set of problems, and they would run fast.
|
|---|
| 35 | Caution: no side-effects in arguments please!! They may be
|
|---|
| 36 | evaluated MANY times!!
|
|---|
| 37 |
|
|---|
| 38 | These macros operate a stack of objects. Each object starts life
|
|---|
| 39 | small, and may grow to maturity. (Consider building a word syllable
|
|---|
| 40 | by syllable.) An object can move while it is growing. Once it has
|
|---|
| 41 | been "finished" it never changes address again. So the "top of the
|
|---|
|
|---|
