diff options
Diffstat (limited to 'gs/src/ostack.h')
-rw-r--r-- | gs/src/ostack.h | 88 |
1 files changed, 88 insertions, 0 deletions
diff --git a/gs/src/ostack.h b/gs/src/ostack.h new file mode 100644 index 000000000..54e8e5a34 --- /dev/null +++ b/gs/src/ostack.h @@ -0,0 +1,88 @@ +/* Copyright (C) 1991, 1994, 1996 Aladdin Enterprises. All rights reserved. + + This file is part of Aladdin Ghostscript. + + Aladdin Ghostscript is distributed with NO WARRANTY OF ANY KIND. No author + or distributor accepts any responsibility for the consequences of using it, + or for whether it serves any particular purpose or works at all, unless he + or she says so in writing. Refer to the Aladdin Ghostscript Free Public + License (the "License") for full details. + + Every copy of Aladdin Ghostscript must include a copy of the License, + normally in a plain ASCII text file named PUBLIC. The License grants you + the right to copy, modify and redistribute Aladdin Ghostscript, but only + under certain conditions described in the License. Among other things, the + License requires that the copyright notice and this notice be preserved on + all copies. +*/ + +/* ostack.h */ +/* Definitions for Ghostscript operand stack */ + +#ifndef ostack_INCLUDED +# define ostack_INCLUDED + +#include "istack.h" + +/* Define the operand stack pointers. */ +typedef s_ptr os_ptr; +typedef const_s_ptr const_os_ptr; +extern ref_stack o_stack; +#define osbot (o_stack.bot) +#define osp (o_stack.p) +#define ostop (o_stack.top) + +/* Macro to ensure enough room on the operand stack */ +#define check_ostack(n)\ + if ( ostop - osp < (n) )\ + { o_stack.requested = (n); return_error(e_stackoverflow); } + +/* Operand stack manipulation. */ + +/* Note that push sets osp to (the new value of) op. */ +/* The do... avoids problems with a possible enclosing 'if'. */ +#define push(n)\ + do { if ( (op += (n)) > ostop )\ + { o_stack.requested = (n); return_error(e_stackoverflow); }\ + else osp = op;\ + } while (0) + +/* + * Note that the pop macro only decrements osp, not op. For this reason, + * + * >>> pop should only be used just before returning, <<< + * >>> or else op must be decremented explicitly. <<< + */ +#define pop(n) (osp -= (n)) + +/* + * Note that the interpreter does not check for operand stack underflow + * before calling the operator procedure. There are "guard" entries + * with invalid types and attributes just below the bottom of the + * operand stack: if the operator returns with a typecheck error, + * the interpreter checks for underflow at that time. + * Operators that don't typecheck their arguments must check for + * operand stack underflow explicitly; operators that take a variable + * number of arguments must also check for stack underflow in those cases + * where they expect more than their minimum number of arguments. + * (This is because the interpreter can only recognize that a typecheck + * is really a stackunderflow when the stack has fewer than the + * operator's declared minimum number of entries.) + */ +#define check_op(nargs)\ + if ( op < osbot + ((nargs) - 1) ) return_error(e_stackunderflow) +/* + * Similarly, in order to simplify some overflow checks, we allocate + * a few guard entries just above the top of the o-stack. + */ + +/* + * The operand stack is implemented as a linked list of blocks; + * operators that can push or pop an unbounded number of values, or that + * access the entire o-stack, must take this into account. These are: + * (int)copy index roll clear count cleartomark + * counttomark aload astore packedarray + * getdeviceprops putdeviceprops + */ + +#endif /* ostack_INCLUDED */ |