libguile/eval.h

   1 /* classes: h_files */
   2
   3 #ifndef SCM_EVAL_H
   4 #define SCM_EVAL_H
   5 /* Copyright (C) 1995,1996,1998,1999,2000,2001 Free Software Foundation, Inc.
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2, or (at your option)
  10  * any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with this software; see the file COPYING.  If not, write to
  19  * the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  20  * Boston, MA 02111-1307 USA
  21  *
  22  * As a special exception, the Free Software Foundation gives permission
  23  * for additional uses of the text contained in its release of GUILE.
  24  *
  25  * The exception is that, if you link the GUILE library with other files
  26  * to produce an executable, this does not by itself cause the
  27  * resulting executable to be covered by the GNU General Public License.
  28  * Your use of that executable is in no way restricted on account of
  29  * linking the GUILE library code into it.
  30  *
  31  * This exception does not however invalidate any other reasons why
  32  * the executable file might be covered by the GNU General Public License.
  33  *
  34  * This exception applies only to the code released by the
  35  * Free Software Foundation under the name GUILE.  If you copy
  36  * code from other Free Software Foundation releases into a copy of
  37  * GUILE, as the General Public License permits, the exception does
  38  * not apply to the code that you add in this way.  To avoid misleading
  39  * anyone as to the status of such modified files, you must delete
  40  * this exception notice from them.
  41  *
  42  * If you write modifications of your own for GUILE, it is your choice
  43  * whether to permit this exception to apply to your modifications.
  44  * If you do not wish that, delete this exception notice.  */
  45 \f
  46
  47 #include "libguile/__scm.h"
  48
  49 /* Needed by SCM_TOP_LEVEL_LOOKUP_CLOSURE below. */
  50
  51 #include "struct.h"
  52
  53 \f
  54
  55 /* {Options}
  56  */
  57
  58 extern scm_option scm_eval_opts[];
  59
  60 #define SCM_EVAL_STACK         scm_eval_opts[0].val
  61 #define SCM_N_EVAL_OPTIONS 1
  62
  63 extern int scm_eval_stack;
  64
  65 extern scm_option scm_evaluator_trap_table[];
  66
  67 extern SCM scm_eval_options_interface (SCM setting);
  68
  69 #define SCM_TRAPS_P            scm_evaluator_trap_table[0].val
  70 #define SCM_ENTER_FRAME_P      scm_evaluator_trap_table[1].val
  71 #define SCM_APPLY_FRAME_P      scm_evaluator_trap_table[2].val
  72 #define SCM_EXIT_FRAME_P       scm_evaluator_trap_table[3].val
  73 #define SCM_N_EVALUATOR_TRAPS 4
  74
  75 \f
  76
  77 /* {Ilocs}
  78  *
  79  * Ilocs are relative pointers into local environment structures.
  80  *
  81  */
  82 #define SCM_ILOCP(n)            (SCM_ITAG8(n)==scm_tc8_iloc)
  83 #define SCM_ILOC00              SCM_MAKE_ITAG8(0L, scm_tc8_iloc)
  84 #define SCM_IDINC               (0x00100000L)
  85 #define SCM_ICDR                (0x00080000L)
  86 #define SCM_IFRINC              (0x00000100L)
  87 #define SCM_IDSTMSK             (-SCM_IDINC)
  88 #define SCM_IFRAME(n)           ((int)((SCM_ICDR-SCM_IFRINC)>>8) \
  89                                  & (SCM_UNPACK (n) >> 8))
  90 #define SCM_IDIST(n)            (SCM_UNPACK (n) >> 20)
  91 #define SCM_ICDRP(n)            (SCM_ICDR & SCM_UNPACK (n))
  92
  93 \f
  94
  95
  96 /* {Evaluator}
  97  *
  98  * For an explanation of symbols containing "EVAL", see beginning of eval.c.
  99  */
 100 #define SCM_EVALIM2(x) (((x) == SCM_EOL) \
 101                         ? scm_misc_error (NULL, scm_s_expression, SCM_EOL), 0 \
 102                         : (x))
 103 #ifdef MEMOIZE_LOCALS
 104 #define SCM_EVALIM(x, env) (SCM_ILOCP (x) \
 105                             ? *scm_ilookup ((x), env) \
 106                             : SCM_EVALIM2(x))
 107 #else
 108 #define SCM_EVALIM(x, env) SCM_EVALIM2(x)
 109 #endif
 110 #ifdef DEBUG_EXTENSIONS
 111 #define SCM_XEVAL(x, env) (SCM_IMP (x) \
 112                            ? SCM_EVALIM2(x) \
 113                            : (*scm_ceval_ptr) ((x), (env)))
 114 #define SCM_XEVALCAR(x, env) (SCM_NCELLP (SCM_CAR (x)) \
 115                               ? (SCM_IMP (SCM_CAR (x)) \
 116                                  ? SCM_EVALIM (SCM_CAR (x), env) \
 117                                  : SCM_GLOC_VAL (SCM_CAR (x))) \
 118                               : (SCM_SYMBOLP (SCM_CAR (x)) \
 119                                  ? *scm_lookupcar (x, env, 1) \
 120                                  : (*scm_ceval_ptr) (SCM_CAR (x), env)))
 121 #else
 122 #define SCM_XEVAL(x, env) (SCM_IMP (x) \
 123                            ? SCM_EVALIM2(x) \
 124                            : scm_ceval ((x), (env)))
 125 #define SCM_XEVALCAR(x, env) EVALCAR (x, env)
 126 #endif /* DEBUG_EXTENSIONS */
 127
 128 \f
 129
 130 #define SCM_EXTEND_ENV scm_acons
 131
 132 /*fixme* This should probably be removed throught the code. */
 133
 134 #define SCM_TOP_LEVEL_LOOKUP_CLOSURE \
 135   SCM_MODULE_EVAL_CLOSURE (scm_current_module ())
 136
 137 #if SCM_DEBUG_DEPRECATED == 0
 138
 139 extern SCM scm_top_level_lookup_closure_var;
 140 #endif
 141
 142 extern SCM scm_system_transformer;
 143
 144 \f
 145 extern const char scm_s_expression[];
 146 extern const char scm_s_test[];
 147 extern const char scm_s_body[];
 148 extern const char scm_s_bindings[];
 149 extern const char scm_s_variable[];
 150 extern const char scm_s_clauses[];
 151 extern const char scm_s_formals[];
 152 extern const char scm_s_set_x[];
 153
 154 extern SCM scm_sym_and;
 155 extern SCM scm_sym_begin;
 156 extern SCM scm_sym_case;
 157 extern SCM scm_sym_cond;
 158 extern SCM scm_sym_define;
 159 extern SCM scm_sym_do;
 160 extern SCM scm_sym_if;
 161 extern SCM scm_sym_lambda;
 162 extern SCM scm_sym_let;
 163 extern SCM scm_sym_letstar;
 164 extern SCM scm_sym_letrec;
 165 extern SCM scm_sym_quote;
 166 extern SCM scm_sym_quasiquote;
 167 extern SCM scm_sym_unquote;
 168 extern SCM scm_sym_uq_splicing;
 169
 170 extern SCM scm_sym_dot;
 171 extern SCM scm_sym_atapply;
 172 extern SCM scm_sym_atcall_cc;
 173 extern SCM scm_sym_at_call_with_values;
 174 extern SCM scm_sym_delay;
 175 extern SCM scm_sym_arrow;
 176 extern SCM scm_sym_else;
 177 extern SCM scm_sym_apply;
 178 extern SCM scm_sym_set_x;
 179 extern SCM scm_sym_args;
 180
 181 extern SCM scm_f_apply;
 182
 183 /* A resolved global variable reference in the CAR position
 184  * of a list is stored (in code only) as a pointer to a pair with a
 185  * tag of 1.  This is called a "gloc".
 186  */
 187
 188 #define SCM_GLOC_SYM(x) (SCM_CAR (SCM_PACK (SCM_UNPACK (x) - 1L)))
 189 #define SCM_GLOC_VAL(x) (SCM_CDR (SCM_PACK (SCM_UNPACK (x) - 1L)))
 190 #define SCM_GLOC_VAL_LOC(x) (SCM_CDRLOC (SCM_PACK (SCM_UNPACK (x) - 1L)))
 191
 192 \f
 193
 194 extern SCM * scm_ilookup (SCM iloc, SCM env);
 195 extern SCM * scm_lookupcar (SCM vloc, SCM genv, int check);
 196 extern SCM scm_unmemocar (SCM form, SCM env);
 197 extern SCM scm_unmemocopy (SCM form, SCM env);
 198 extern SCM scm_eval_car (SCM pair, SCM env);
 199 extern SCM scm_eval_body (SCM code, SCM env);
 200 extern SCM scm_eval_args (SCM i, SCM env, SCM proc);
 201 extern SCM scm_deval_args (SCM l, SCM env, SCM proc, SCM *lloc);
 202 extern SCM scm_m_quote (SCM xorig, SCM env);
 203 extern SCM scm_m_begin (SCM xorig, SCM env);
 204 extern SCM scm_m_if (SCM xorig, SCM env);
 205 extern SCM scm_m_set_x (SCM xorig, SCM env);
 206 extern SCM scm_m_vref (SCM xorig, SCM env);
 207 extern SCM scm_m_vset (SCM xorig, SCM env);
 208 extern SCM scm_m_and (SCM xorig, SCM env);
 209 extern SCM scm_m_or (SCM xorig, SCM env);
 210 extern SCM scm_m_case (SCM xorig, SCM env);
 211 extern SCM scm_m_cond (SCM xorig, SCM env);
 212 extern SCM scm_m_lambda (SCM xorig, SCM env);
 213 extern SCM scm_m_letstar (SCM xorig, SCM env);
 214 extern SCM scm_m_do (SCM xorig, SCM env);
 215 extern SCM scm_m_quasiquote (SCM xorig, SCM env);
 216 extern SCM scm_m_delay (SCM xorig, SCM env);
 217 extern SCM scm_m_define (SCM x, SCM env);
 218 extern SCM scm_m_letrec (SCM xorig, SCM env);
 219 extern SCM scm_m_let (SCM xorig, SCM env);
 220 extern SCM scm_m_apply (SCM xorig, SCM env);
 221 extern SCM scm_m_cont (SCM xorig, SCM env);
 222 extern SCM scm_m_nil_cond (SCM xorig, SCM env);
 223 extern SCM scm_m_nil_ify (SCM xorig, SCM env);
 224 extern SCM scm_m_t_ify (SCM xorig, SCM env);
 225 extern SCM scm_m_0_cond (SCM xorig, SCM env);
 226 extern SCM scm_m_0_ify (SCM xorig, SCM env);
 227 extern SCM scm_m_1_ify (SCM xorig, SCM env);
 228 extern SCM scm_m_atfop (SCM xorig, SCM env);
 229 extern SCM scm_m_atbind (SCM xorig, SCM env);
 230 extern SCM scm_m_at_call_with_values (SCM xorig, SCM env);
 231 extern int scm_badargsp (SCM formals, SCM args);
 232 extern SCM scm_ceval (SCM x, SCM env);
 233 extern SCM scm_deval (SCM x, SCM env);
 234 extern SCM scm_nconc2last (SCM lst);
 235 extern SCM scm_apply (SCM proc, SCM arg1, SCM args);
 236 extern SCM scm_dapply (SCM proc, SCM arg1, SCM args);
 237 extern SCM scm_m_expand_body (SCM xorig, SCM env);
 238 extern SCM scm_macroexp (SCM x, SCM env);
 239 extern SCM scm_map (SCM proc, SCM arg1, SCM args);
 240 extern SCM scm_for_each (SCM proc, SCM arg1, SCM args);
 241 extern SCM scm_closure (SCM code, SCM env);
 242 extern SCM scm_makprom (SCM code);
 243 extern SCM scm_force (SCM x);
 244 extern SCM scm_promise_p (SCM x);
 245 extern SCM scm_cons_source (SCM xorig, SCM x, SCM y);
 246 extern SCM scm_copy_tree (SCM obj);
 247 #if SCM_DEBUG_DEPRECATED == 0
 248 extern SCM scm_eval_3 (SCM obj, int copyp, SCM env);
 249 extern SCM scm_eval2 (SCM obj, SCM env_thunk);
 250 #endif
 251 extern SCM scm_i_eval_x (SCM exp, SCM env);
 252 extern SCM scm_i_eval (SCM exp, SCM env);
 253 extern SCM scm_primitive_eval (SCM exp);
 254 extern SCM scm_primitive_eval_x (SCM exp);
 255 extern SCM scm_eval (SCM exp, SCM module);
 256 extern SCM scm_eval_x (SCM exp, SCM module);
 257
 258 extern void scm_init_eval (void);
 259
 260 #endif  /* SCM_EVAL_H */
 261
 262 /*
 263   Local Variables:
 264   c-file-style: "gnu"
 265   End:
 266 */