libguile/goops.h

   1 /* classes: h_files */
   2
   3 #ifndef GOOPSH
   4 #define GOOPSH
   5 /*      Copyright (C) 1998, 1999, 2000 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 /* This software is a derivative work of other copyrighted softwares; the
  48  * copyright notices of these softwares are placed in the file COPYRIGHTS
  49  *
  50  * This file is based upon stklos.h from the STk distribution by
  51  * Erick Gallesio <eg@unice.fr>.
  52  */
  53
  54 #include "libguile/__scm.h"
  55
  56 /*
  57  * scm_class_class
  58  */
  59
  60 #define SCM_CLASS_CLASS_LAYOUT "pruosrpwpopopwururururururururpwpwpwpwpwpwpwpwpwpwpwpw"
  61
  62 #define scm_si_layout             0 /* the struct layout */
  63 #define scm_si_vcell              1
  64 #define scm_si_vtable             2
  65 #define scm_si_print              3 /* the struct print closure */
  66 #define scm_si_proc               4
  67 #define scm_si_setter             5
  68
  69 #define scm_si_goops_fields       6
  70
  71 /* Defined in libguile/objects.c:
  72 #define scm_si_redefined          6    The class to which class was redefined.
  73 #define scm_si_hashsets           7
  74 */
  75 #define scm_si_name              15 /* a symbol */
  76 #define scm_si_direct_supers     16 /* (class ...) */
  77 #define scm_si_direct_slots      17 /* ((name . options) ...) */
  78 #define scm_si_direct_subclasses 18 /* (class ...) */
  79 #define scm_si_direct_methods    19 /* (methods ...) */
  80 #define scm_si_cpl               20 /* (class ...) */
  81 #define scm_si_slotdef_class     21
  82 #define scm_si_slots             22 /* ((name . options) ...) */
  83 #define scm_si_name_access       23
  84 #define scm_si_keyword_access    24
  85 #define scm_si_nfields           25 /* an integer */
  86 #define scm_si_environment       26 /* The environment in which class is built  */
  87 #define SCM_N_CLASS_SLOTS        27
  88
  89 typedef struct scm_method_t {
  90   SCM generic_function;
  91   SCM specializers;
  92   SCM procedure;
  93 } scm_method_t;
  94
  95 #define SCM_METHOD(obj) ((scm_method_t *) SCM_STRUCT_DATA (obj))
  96
  97 #define SCM_CLASSF_SIMPLE_METHOD    (0x004 << 20)
  98 #define SCM_CLASSF_ACCESSOR_METHOD  (0x008 << 20)
  99
 100 /* Defined in libguile/objects.c */
 101 /* #define SCM_CLASSF_PURE_GENERIC  (0x010 << 20) */
 102
 103 #define SCM_CLASSF_FOREIGN          (0x020 << 20)
 104 #define SCM_CLASSF_METACLASS        (0x040 << 20)
 105
 106 /* Defined in libguile/objects.c */
 107 /* #define SCM_CLASSF_GOOPS_VALID   (0x080 << 20) */
 108 /* #define SCM_CLASSF_GOOPS         (0x100 << 20) */
 109 #define SCM_CLASSF_GOOPS_OR_VALID (SCM_CLASSF_GOOPS | SCM_CLASSF_GOOPS_VALID)
 110
 111 #define SCM_CLASSF_INHERIT       (~(SCM_CLASSF_PURE_GENERIC \
 112                                     | SCM_CLASSF_SIMPLE_METHOD \
 113                                     | SCM_CLASSF_ACCESSOR_METHOD \
 114                                     | SCM_STRUCTF_LIGHT) \
 115                                   & SCM_CLASSF_MASK)
 116
 117 #define SCM_INST(x)            SCM_STRUCT_DATA (x)
 118 #define SCM_INST_TYPE(x)       SCM_OBJ_CLASS_FLAGS (x)
 119 /* Also defined in libguuile/objects.c */
 120 #define SCM_CLASS_OF(x)        SCM_STRUCT_VTABLE (x)
 121 #define SCM_ACCESSORS_OF(x)    (SCM_STRUCT_VTABLE_DATA (x)[scm_si_getters_n_setters])
 122 #define SCM_NUMBER_OF_SLOTS(x)\
 123  (SCM_UNPACK (SCM_STRUCT_DATA (x)[scm_struct_i_n_words]) \
 124   - scm_struct_n_extra_words) \
 125
 126 #define SCM_INSTANCEP(x)       (SCM_STRUCTP (x) \
 127                                && (SCM_INST_TYPE (x) & SCM_CLASSF_GOOPS))
 128
 129 #define SCM_PUREGENERICP(x)    (SCM_INST_TYPE(x) & SCM_CLASSF_PURE_GENERIC)
 130 #define SCM_SIMPLEMETHODP(x)   (SCM_INST_TYPE(x) & SCM_CLASSF_SIMPLE_METHOD)
 131 #define SCM_ACCESSORP(x)       (SCM_INST_TYPE(x) & SCM_CLASSF_ACCESSOR_METHOD)
 132 #define SCM_FASTMETHODP(x)     (SCM_INST_TYPE(x) \
 133                                 & (SCM_CLASSF_ACCESSOR_METHOD \
 134                                    | SCM_CLASSF_SIMPLE_METHOD))
 135
 136 #define SCM_SLOT(x, i)         (SCM_INST(x)[i])
 137 #define SCM_SUBCLASSP(c1, c2)  SCM_NNULLP (scm_memq (c2, SCM_SLOT (c1, scm_si_cpl)))
 138 #define SCM_IS_A_P(x, c)       (SCM_NIMP (x) \
 139                                 && SCM_INSTANCEP (x) \
 140                                 && SCM_SUBCLASSP (SCM_CLASS_OF (x), c))
 141
 142 #define SCM_MCACHE_N_SPECIALIZED(C) SCM_CADDR (C)
 143 #define SCM_SET_MCACHE_N_SPECIALIZED(C, X) SCM_SETCAR (SCM_CDDR (C), X)
 144
 145 #define SCM_INITIAL_MCACHE_SIZE   1
 146
 147 #define scm_si_getters_n_setters scm_si_name_access
 148
 149 #define scm_si_constructor       SCM_N_CLASS_SLOTS
 150 #define scm_si_destructor        SCM_N_CLASS_SLOTS + 1
 151
 152 #define scm_si_methods           0  /* offset of methods slot in a <generic> */
 153 #define scm_si_n_specialized     1
 154 #define scm_si_used_by           2
 155 #define scm_si_cache_mutex       3
 156
 157 #define scm_si_generic_function  0  /* offset of gf    slot in a <method> */
 158 #define scm_si_specializers      1  /* offset of spec. slot in a <method> */
 159
 160 #define scm_si_procedure         2  /* offset of proc. slot in a <method> */
 161 #define scm_si_code_table        3  /* offset of code. slot in a <method> */
 162
 163 /* C interface */
 164 extern SCM scm_class_top, scm_class_object, scm_class_class;
 165 extern SCM scm_class_entity, scm_class_entity_with_setter;
 166 extern SCM scm_class_generic, scm_class_generic_with_setter, scm_class_method;
 167 extern SCM scm_class_simple_method, scm_class_accessor;
 168 extern SCM scm_class_procedure_class;
 169 extern SCM scm_class_operator_class, scm_class_operator_with_setter_class;
 170 extern SCM scm_class_entity_class;
 171 extern SCM scm_class_number, scm_class_list;
 172 extern SCM scm_class_keyword;
 173 extern SCM scm_class_port, scm_class_input_output_port;
 174 extern SCM scm_class_input_port, scm_class_output_port;
 175 extern SCM scm_class_foreign_class, scm_class_foreign_object;
 176 extern SCM scm_class_foreign_slot;
 177 extern SCM scm_class_self, scm_class_protected;
 178 extern SCM scm_class_opaque, scm_class_read_only;
 179 extern SCM scm_class_protected_opaque, scm_class_protected_read_only;
 180 extern SCM scm_class_scm;
 181 extern SCM scm_class_int, scm_class_float, scm_class_double;
 182 extern const char *scm_s_slot_set_x;
 183
 184 extern SCM scm_module_goops;
 185
 186 SCM scm_goops_version (void);
 187 SCM scm_oldfmt (SCM);
 188 char *scm_c_oldfmt0 (char *);
 189 char *scm_c_oldfmt (char *, int n);
 190 void scm_load_goops (void);
 191 SCM scm_make_foreign_object (SCM cls, SCM initargs);
 192 SCM scm_make_class (SCM meta, char *s_name, SCM supers, size_t size,
 193                     void * (*constructor) (SCM initargs),
 194                     size_t (*destructor) (void *));
 195 void scm_add_slot (SCM c, char *slot, SCM slot_class,
 196                    SCM (*getter) (SCM obj),
 197                    SCM (*setter) (SCM obj, SCM x),
 198                    char *accessor_name);
 199 SCM scm_wrap_object (SCM c, void *);
 200 SCM scm_wrap_component (SCM c, SCM obj, void *);
 201 SCM scm_ensure_accessor (SCM name);
 202 void scm_add_method (SCM gf, SCM m);
 203
 204 /* Low level functions exported */
 205 SCM scm_make_next_method (SCM methods, SCM args, SCM gf);
 206 SCM scm_basic_basic_make_class (SCM c, SCM name, SCM dsupers, SCM dslots);
 207 SCM scm_basic_make_class (SCM c, SCM name, SCM dsupers, SCM dslots);
 208
 209 /* Primitives exported */
 210 SCM scm_sys_allocate_instance (SCM c, SCM initargs);
 211 SCM scm_sys_set_object_setter_x (SCM obj, SCM setter);
 212 SCM scm_slot_ref (SCM obj, SCM slot_name);
 213 SCM scm_slot_set_x (SCM obj, SCM slot_name, SCM value);
 214
 215 SCM scm_compute_applicable_methods (SCM gf, SCM args, int len, int scm_find_method);
 216 SCM scm_sys_compute_applicable_methods (SCM gf, SCM args);
 217 SCM scm_m_atslot_ref (SCM xorig, SCM env);
 218 SCM scm_m_atslot_set_x (SCM xorig, SCM env);
 219 SCM scm_m_atdispatch (SCM xorig, SCM env);
 220 #ifdef GUILE_DEBUG
 221 SCM scm_pure_generic_p (SCM obj);
 222 #endif
 223 extern void scm_init_oop_goops_goopscore_module (void);
 224
 225 SCM scm_sys_compute_slots (SCM c);
 226 SCM scm_i_get_keyword (SCM key, SCM l, int len, SCM default_value, const char *subr);
 227 SCM scm_get_keyword (SCM key, SCM l, SCM default_value);
 228 SCM scm_sys_initialize_object (SCM obj, SCM initargs);
 229 SCM scm_sys_prep_layout_x (SCM c);
 230 SCM scm_sys_inherit_magic_x (SCM c, SCM dsupers);
 231 SCM scm_instance_p (SCM obj);
 232 SCM scm_class_name (SCM obj);
 233 SCM scm_class_direct_supers (SCM obj);
 234 SCM scm_class_direct_slots (SCM obj);
 235 SCM scm_class_direct_subclasses (SCM obj);
 236 SCM scm_class_direct_methods (SCM obj);
 237 SCM scm_class_precedence_list (SCM obj);
 238 SCM scm_class_slots (SCM obj);
 239 SCM scm_class_environment (SCM obj);
 240 SCM scm_generic_function_name (SCM obj);
 241 SCM scm_generic_function_methods (SCM obj);
 242 SCM scm_method_generic_function (SCM obj);
 243 SCM scm_method_specializers (SCM obj);
 244 SCM scm_method_procedure (SCM obj);
 245 SCM scm_accessor_method_slot_definition (SCM obj);
 246 SCM scm_sys_fast_slot_ref (SCM obj, SCM index);
 247 SCM scm_sys_fast_slot_set_x (SCM obj, SCM index, SCM value);
 248 SCM scm_slot_ref_using_class (SCM cls, SCM obj, SCM slot_name);
 249 SCM scm_slot_set_using_class_x (SCM cls, SCM obj, SCM slot_name, SCM value);
 250 SCM scm_slot_bound_using_class_p (SCM cls, SCM obj, SCM slot_name);
 251 SCM scm_slot_exists_using_class_p (SCM cls, SCM obj, SCM slot_name);
 252 SCM scm_slot_bound_p (SCM obj, SCM slot_name);
 253 SCM scm_slots_exists_p (SCM obj, SCM slot_name);
 254 SCM scm_sys_modify_instance (SCM old, SCM newinst);
 255 SCM scm_sys_modify_class (SCM old, SCM newcls);
 256 SCM scm_sys_invalidate_class (SCM cls);
 257 SCM scm_make_method_cache (SCM gf);
 258 SCM scm_sys_invalidate_method_cache_x (SCM gf);
 259 SCM scm_generic_capability_p (SCM proc);
 260 SCM scm_enable_primitive_generic_x (SCM subrs);
 261 SCM scm_primitive_generic_generic (SCM subr);
 262 SCM stklos_version (void);
 263 SCM scm_make (SCM args);
 264 SCM scm_find_method (SCM args);
 265 SCM scm_sys_method_more_specific_p (SCM m1, SCM m2, SCM targs);
 266 void scm_init_goops (void);
 267
 268 #endif /* GOOPSH */