merge guile-vm to guile
[bpt/guile.git] / libguile / goops.c
1 /* Copyright (C) 1998,1999,2000,2001,2002,2003,2004,2008
2 * Free Software Foundation, Inc.
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
8 *
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17 */
18 \f
19
20 /* This software is a derivative work of other copyrighted softwares; the
21 * copyright notices of these softwares are placed in the file COPYRIGHTS
22 *
23 * This file is based upon stklos.c from the STk distribution by
24 * Erick Gallesio <eg@unice.fr>.
25 */
26
27 #include <stdio.h>
28
29 #include "libguile/_scm.h"
30 #include "libguile/alist.h"
31 #include "libguile/async.h"
32 #include "libguile/chars.h"
33 #include "libguile/debug.h"
34 #include "libguile/dynl.h"
35 #include "libguile/dynwind.h"
36 #include "libguile/eval.h"
37 #include "libguile/hashtab.h"
38 #include "libguile/keywords.h"
39 #include "libguile/macros.h"
40 #include "libguile/modules.h"
41 #include "libguile/objects.h"
42 #include "libguile/ports.h"
43 #include "libguile/procprop.h"
44 #include "libguile/random.h"
45 #include "libguile/root.h"
46 #include "libguile/smob.h"
47 #include "libguile/strings.h"
48 #include "libguile/strports.h"
49 #include "libguile/vectors.h"
50 #include "libguile/weaks.h"
51
52 #include "libguile/validate.h"
53 #include "libguile/goops.h"
54
55 #define SPEC_OF(x) SCM_SLOT (x, scm_si_specializers)
56
57 #define DEFVAR(v, val) \
58 { scm_eval (scm_list_3 (scm_sym_define_public, (v), (val)), \
59 scm_module_goops); }
60 /* Temporary hack until we get the new module system */
61 /*fixme* Should optimize by keeping track of the variable object itself */
62 #define GETVAR(v) (SCM_VARIABLE_REF (scm_call_2 (scm_goops_lookup_closure, \
63 (v), SCM_BOOL_F)))
64
65 /* Fixme: Should use already interned symbols */
66
67 #define CALL_GF1(name, a) (scm_call_1 (GETVAR (scm_from_locale_symbol (name)), \
68 a))
69 #define CALL_GF2(name, a, b) (scm_call_2 (GETVAR (scm_from_locale_symbol (name)), \
70 a, b))
71 #define CALL_GF3(name, a, b, c) (scm_call_3 (GETVAR (scm_from_locale_symbol (name)), \
72 a, b, c))
73 #define CALL_GF4(name, a, b, c, d) (scm_call_4 (GETVAR (scm_from_locale_symbol (name)), \
74 a, b, c, d))
75
76 /* Class redefinition protocol:
77
78 A class is represented by a heap header h1 which points to a
79 malloc:ed memory block m1.
80
81 When a new version of a class is created, a new header h2 and
82 memory block m2 are allocated. The headers h1 and h2 then switch
83 pointers so that h1 refers to m2 and h2 to m1. In this way, names
84 bound to h1 will point to the new class at the same time as h2 will
85 be a handle which the GC will use to free m1.
86
87 The `redefined' slot of m1 will be set to point to h1. An old
88 instance will have its class pointer (the CAR of the heap header)
89 pointing to m1. The non-immediate `redefined'-slot in m1 indicates
90 the class modification and the new class pointer can be found via
91 h1.
92 */
93
94 /* The following definition is located in libguile/objects.h:
95 #define SCM_OBJ_CLASS_REDEF(x) (SCM_STRUCT_VTABLE_DATA(x)[scm_si_redefined])
96 */
97
98 #define TEST_CHANGE_CLASS(obj, class) \
99 { \
100 class = SCM_CLASS_OF (obj); \
101 if (scm_is_true (SCM_OBJ_CLASS_REDEF (obj))) \
102 { \
103 scm_change_object_class (obj, class, SCM_OBJ_CLASS_REDEF (obj));\
104 class = SCM_CLASS_OF (obj); \
105 } \
106 }
107
108 #define NXT_MTHD_METHODS(m) (SCM_VELTS (m)[1])
109 #define NXT_MTHD_ARGS(m) (SCM_VELTS (m)[2])
110
111 #define SCM_GOOPS_UNBOUND SCM_UNBOUND
112 #define SCM_GOOPS_UNBOUNDP(x) ((x) == SCM_GOOPS_UNBOUND)
113
114 static int goops_loaded_p = 0;
115 static scm_t_rstate *goops_rstate;
116
117 static SCM scm_goops_lookup_closure;
118
119 /* These variables are filled in by the object system when loaded. */
120 SCM scm_class_boolean, scm_class_char, scm_class_pair;
121 SCM scm_class_procedure, scm_class_string, scm_class_symbol;
122 SCM scm_class_procedure_with_setter, scm_class_primitive_generic;
123 SCM scm_class_vector, scm_class_null;
124 SCM scm_class_integer, scm_class_real, scm_class_complex, scm_class_fraction;
125 SCM scm_class_unknown;
126 SCM scm_class_top, scm_class_object, scm_class_class;
127 SCM scm_class_applicable;
128 SCM scm_class_entity, scm_class_entity_with_setter;
129 SCM scm_class_generic, scm_class_generic_with_setter;
130 SCM scm_class_accessor;
131 SCM scm_class_extended_generic, scm_class_extended_generic_with_setter;
132 SCM scm_class_extended_accessor;
133 SCM scm_class_method;
134 SCM scm_class_simple_method, scm_class_accessor_method;
135 SCM scm_class_procedure_class;
136 SCM scm_class_operator_class, scm_class_operator_with_setter_class;
137 SCM scm_class_entity_class;
138 SCM scm_class_number, scm_class_list;
139 SCM scm_class_keyword;
140 SCM scm_class_port, scm_class_input_output_port;
141 SCM scm_class_input_port, scm_class_output_port;
142 SCM scm_class_foreign_class, scm_class_foreign_object;
143 SCM scm_class_foreign_slot;
144 SCM scm_class_self, scm_class_protected;
145 SCM scm_class_opaque, scm_class_read_only;
146 SCM scm_class_protected_opaque, scm_class_protected_read_only;
147 SCM scm_class_scm;
148 SCM scm_class_int, scm_class_float, scm_class_double;
149
150 SCM *scm_port_class = 0;
151 SCM *scm_smob_class = 0;
152
153 SCM scm_no_applicable_method;
154
155 SCM_SYMBOL (scm_sym_define_public, "define-public");
156
157 static SCM scm_make_unbound (void);
158 static SCM scm_unbound_p (SCM obj);
159 static SCM scm_assert_bound (SCM value, SCM obj);
160 static SCM scm_at_assert_bound_ref (SCM obj, SCM index);
161 static SCM scm_sys_goops_loaded (void);
162
163 /* This function is used for efficient type dispatch. */
164 SCM_DEFINE (scm_class_of, "class-of", 1, 0, 0,
165 (SCM x),
166 "Return the class of @var{x}.")
167 #define FUNC_NAME s_scm_class_of
168 {
169 switch (SCM_ITAG3 (x))
170 {
171 case scm_tc3_int_1:
172 case scm_tc3_int_2:
173 return scm_class_integer;
174
175 case scm_tc3_imm24:
176 if (SCM_CHARP (x))
177 return scm_class_char;
178 else if (scm_is_bool (x))
179 return scm_class_boolean;
180 else if (scm_is_null (x))
181 return scm_class_null;
182 else
183 return scm_class_unknown;
184
185 case scm_tc3_cons:
186 switch (SCM_TYP7 (x))
187 {
188 case scm_tcs_cons_nimcar:
189 return scm_class_pair;
190 case scm_tcs_closures:
191 return scm_class_procedure;
192 case scm_tc7_symbol:
193 return scm_class_symbol;
194 case scm_tc7_vector:
195 case scm_tc7_wvect:
196 return scm_class_vector;
197 case scm_tc7_string:
198 return scm_class_string;
199 case scm_tc7_number:
200 switch SCM_TYP16 (x) {
201 case scm_tc16_big:
202 return scm_class_integer;
203 case scm_tc16_real:
204 return scm_class_real;
205 case scm_tc16_complex:
206 return scm_class_complex;
207 case scm_tc16_fraction:
208 return scm_class_fraction;
209 }
210 case scm_tc7_asubr:
211 case scm_tc7_subr_0:
212 case scm_tc7_subr_1:
213 case scm_tc7_dsubr:
214 case scm_tc7_cxr:
215 case scm_tc7_subr_3:
216 case scm_tc7_subr_2:
217 case scm_tc7_rpsubr:
218 case scm_tc7_subr_1o:
219 case scm_tc7_subr_2o:
220 case scm_tc7_lsubr_2:
221 case scm_tc7_lsubr:
222 if (SCM_SUBR_GENERIC (x) && *SCM_SUBR_GENERIC (x))
223 return scm_class_primitive_generic;
224 else
225 return scm_class_procedure;
226 case scm_tc7_cclo:
227 return scm_class_procedure;
228 case scm_tc7_pws:
229 return scm_class_procedure_with_setter;
230
231 case scm_tc7_smob:
232 {
233 scm_t_bits type = SCM_TYP16 (x);
234 if (type != scm_tc16_port_with_ps)
235 return scm_smob_class[SCM_TC2SMOBNUM (type)];
236 x = SCM_PORT_WITH_PS_PORT (x);
237 /* fall through to ports */
238 }
239 case scm_tc7_port:
240 return scm_port_class[(SCM_WRTNG & SCM_CELL_WORD_0 (x)
241 ? (SCM_RDNG & SCM_CELL_WORD_0 (x)
242 ? SCM_INOUT_PCLASS_INDEX | SCM_PTOBNUM (x)
243 : SCM_OUT_PCLASS_INDEX | SCM_PTOBNUM (x))
244 : SCM_IN_PCLASS_INDEX | SCM_PTOBNUM (x))];
245 case scm_tcs_struct:
246 if (SCM_OBJ_CLASS_FLAGS (x) & SCM_CLASSF_GOOPS_VALID)
247 return SCM_CLASS_OF (x);
248 else if (SCM_OBJ_CLASS_FLAGS (x) & SCM_CLASSF_GOOPS)
249 {
250 /* Goops object */
251 if (! scm_is_false (SCM_OBJ_CLASS_REDEF (x)))
252 scm_change_object_class (x,
253 SCM_CLASS_OF (x), /* old */
254 SCM_OBJ_CLASS_REDEF (x)); /* new */
255 return SCM_CLASS_OF (x);
256 }
257 else
258 {
259 /* ordinary struct */
260 SCM handle = scm_struct_create_handle (SCM_STRUCT_VTABLE (x));
261 if (scm_is_true (SCM_STRUCT_TABLE_CLASS (SCM_CDR (handle))))
262 return SCM_STRUCT_TABLE_CLASS (SCM_CDR (handle));
263 else
264 {
265 SCM name = SCM_STRUCT_TABLE_NAME (SCM_CDR (handle));
266 SCM class = scm_make_extended_class (scm_is_true (name)
267 ? scm_i_symbol_chars (name)
268 : 0,
269 SCM_I_OPERATORP (x));
270 SCM_SET_STRUCT_TABLE_CLASS (SCM_CDR (handle), class);
271 return class;
272 }
273 }
274 default:
275 if (scm_is_pair (x))
276 return scm_class_pair;
277 else
278 return scm_class_unknown;
279 }
280
281 case scm_tc3_struct:
282 case scm_tc3_tc7_1:
283 case scm_tc3_tc7_2:
284 case scm_tc3_closure:
285 /* Never reached */
286 break;
287 }
288 return scm_class_unknown;
289 }
290 #undef FUNC_NAME
291
292 /******************************************************************************
293 *
294 * Compute-cpl
295 *
296 * This version doesn't fully handle multiple-inheritance. It serves
297 * only for booting classes and will be overloaded in Scheme
298 *
299 ******************************************************************************/
300
301 static SCM
302 map (SCM (*proc) (SCM), SCM ls)
303 {
304 if (scm_is_null (ls))
305 return ls;
306 else
307 {
308 SCM res = scm_cons (proc (SCM_CAR (ls)), SCM_EOL);
309 SCM h = res;
310 ls = SCM_CDR (ls);
311 while (!scm_is_null (ls))
312 {
313 SCM_SETCDR (h, scm_cons (proc (SCM_CAR (ls)), SCM_EOL));
314 h = SCM_CDR (h);
315 ls = SCM_CDR (ls);
316 }
317 return res;
318 }
319 }
320
321 static SCM
322 filter_cpl (SCM ls)
323 {
324 SCM res = SCM_EOL;
325 while (!scm_is_null (ls))
326 {
327 SCM el = SCM_CAR (ls);
328 if (scm_is_false (scm_c_memq (el, res)))
329 res = scm_cons (el, res);
330 ls = SCM_CDR (ls);
331 }
332 return res;
333 }
334
335 static SCM
336 compute_cpl (SCM class)
337 {
338 if (goops_loaded_p)
339 return CALL_GF1 ("compute-cpl", class);
340 else
341 {
342 SCM supers = SCM_SLOT (class, scm_si_direct_supers);
343 SCM ls = scm_append (scm_acons (class, supers,
344 map (compute_cpl, supers)));
345 return scm_reverse_x (filter_cpl (ls), SCM_EOL);
346 }
347 }
348
349 /******************************************************************************
350 *
351 * compute-slots
352 *
353 ******************************************************************************/
354
355 static SCM
356 remove_duplicate_slots (SCM l, SCM res, SCM slots_already_seen)
357 {
358 SCM tmp;
359
360 if (scm_is_null (l))
361 return res;
362
363 tmp = SCM_CAAR (l);
364 if (!scm_is_symbol (tmp))
365 scm_misc_error ("%compute-slots", "bad slot name ~S", scm_list_1 (tmp));
366
367 if (scm_is_false (scm_c_memq (tmp, slots_already_seen))) {
368 res = scm_cons (SCM_CAR (l), res);
369 slots_already_seen = scm_cons (tmp, slots_already_seen);
370 }
371
372 return remove_duplicate_slots (SCM_CDR (l), res, slots_already_seen);
373 }
374
375 static SCM
376 build_slots_list (SCM dslots, SCM cpl)
377 {
378 register SCM res = dslots;
379
380 for (cpl = SCM_CDR (cpl); !scm_is_null (cpl); cpl = SCM_CDR (cpl))
381 res = scm_append (scm_list_2 (SCM_SLOT (SCM_CAR (cpl),
382 scm_si_direct_slots),
383 res));
384
385 /* res contains a list of slots. Remove slots which appears more than once */
386 return remove_duplicate_slots (scm_reverse (res), SCM_EOL, SCM_EOL);
387 }
388
389 static SCM
390 maplist (SCM ls)
391 {
392 SCM orig = ls;
393 while (!scm_is_null (ls))
394 {
395 if (!scm_is_pair (SCM_CAR (ls)))
396 SCM_SETCAR (ls, scm_cons (SCM_CAR (ls), SCM_EOL));
397 ls = SCM_CDR (ls);
398 }
399 return orig;
400 }
401
402
403 SCM_DEFINE (scm_sys_compute_slots, "%compute-slots", 1, 0, 0,
404 (SCM class),
405 "Return a list consisting of the names of all slots belonging to\n"
406 "class @var{class}, i. e. the slots of @var{class} and of all of\n"
407 "its superclasses.")
408 #define FUNC_NAME s_scm_sys_compute_slots
409 {
410 SCM_VALIDATE_CLASS (1, class);
411 return build_slots_list (SCM_SLOT (class, scm_si_direct_slots),
412 SCM_SLOT (class, scm_si_cpl));
413 }
414 #undef FUNC_NAME
415
416
417 /******************************************************************************
418 *
419 * compute-getters-n-setters
420 *
421 * This version doesn't handle slot options. It serves only for booting
422 * classes and will be overloaded in Scheme.
423 *
424 ******************************************************************************/
425
426 SCM_KEYWORD (k_init_value, "init-value");
427 SCM_KEYWORD (k_init_thunk, "init-thunk");
428
429 static SCM
430 compute_getters_n_setters (SCM slots)
431 {
432 SCM res = SCM_EOL;
433 SCM *cdrloc = &res;
434 long i = 0;
435
436 for ( ; !scm_is_null (slots); slots = SCM_CDR (slots))
437 {
438 SCM init = SCM_BOOL_F;
439 SCM options = SCM_CDAR (slots);
440 if (!scm_is_null (options))
441 {
442 init = scm_get_keyword (k_init_value, options, 0);
443 if (init)
444 {
445 init = scm_i_eval_x (scm_list_3 (scm_sym_lambda,
446 SCM_EOL,
447 scm_list_2 (scm_sym_quote,
448 init)),
449 SCM_EOL);
450 }
451 else
452 init = scm_get_keyword (k_init_thunk, options, SCM_BOOL_F);
453 }
454 *cdrloc = scm_cons (scm_cons (SCM_CAAR (slots),
455 scm_cons (init,
456 scm_from_int (i++))),
457 SCM_EOL);
458 cdrloc = SCM_CDRLOC (*cdrloc);
459 }
460 return res;
461 }
462
463 /******************************************************************************
464 *
465 * initialize-object
466 *
467 ******************************************************************************/
468
469 /*fixme* Manufacture keywords in advance */
470 SCM
471 scm_i_get_keyword (SCM key, SCM l, long len, SCM default_value, const char *subr)
472 {
473 long i;
474
475 for (i = 0; i != len; i += 2)
476 {
477 SCM obj = SCM_CAR (l);
478
479 if (!scm_is_keyword (obj))
480 scm_misc_error (subr, "bad keyword: ~S", scm_list_1 (obj));
481 else if (scm_is_eq (obj, key))
482 return SCM_CADR (l);
483 else
484 l = SCM_CDDR (l);
485 }
486
487 return default_value;
488 }
489
490
491 SCM_DEFINE (scm_get_keyword, "get-keyword", 3, 0, 0,
492 (SCM key, SCM l, SCM default_value),
493 "Determine an associated value for the keyword @var{key} from\n"
494 "the list @var{l}. The list @var{l} has to consist of an even\n"
495 "number of elements, where, starting with the first, every\n"
496 "second element is a keyword, followed by its associated value.\n"
497 "If @var{l} does not hold a value for @var{key}, the value\n"
498 "@var{default_value} is returned.")
499 #define FUNC_NAME s_scm_get_keyword
500 {
501 long len;
502
503 SCM_ASSERT (scm_is_keyword (key), key, SCM_ARG1, FUNC_NAME);
504 len = scm_ilength (l);
505 if (len < 0 || len % 2 == 1)
506 scm_misc_error (FUNC_NAME, "Bad keyword-value list: ~S", scm_list_1 (l));
507
508 return scm_i_get_keyword (key, l, len, default_value, FUNC_NAME);
509 }
510 #undef FUNC_NAME
511
512
513 SCM_KEYWORD (k_init_keyword, "init-keyword");
514
515 static SCM get_slot_value (SCM class, SCM obj, SCM slotdef);
516 static SCM set_slot_value (SCM class, SCM obj, SCM slotdef, SCM value);
517
518 SCM_DEFINE (scm_sys_initialize_object, "%initialize-object", 2, 0, 0,
519 (SCM obj, SCM initargs),
520 "Initialize the object @var{obj} with the given arguments\n"
521 "@var{initargs}.")
522 #define FUNC_NAME s_scm_sys_initialize_object
523 {
524 SCM tmp, get_n_set, slots;
525 SCM class = SCM_CLASS_OF (obj);
526 long n_initargs;
527
528 SCM_VALIDATE_INSTANCE (1, obj);
529 n_initargs = scm_ilength (initargs);
530 SCM_ASSERT ((n_initargs & 1) == 0, initargs, SCM_ARG2, FUNC_NAME);
531
532 get_n_set = SCM_SLOT (class, scm_si_getters_n_setters);
533 slots = SCM_SLOT (class, scm_si_slots);
534
535 /* See for each slot how it must be initialized */
536 for (;
537 !scm_is_null (slots);
538 get_n_set = SCM_CDR (get_n_set), slots = SCM_CDR (slots))
539 {
540 SCM slot_name = SCM_CAR (slots);
541 SCM slot_value = 0;
542
543 if (!scm_is_null (SCM_CDR (slot_name)))
544 {
545 /* This slot admits (perhaps) to be initialized at creation time */
546 long n = scm_ilength (SCM_CDR (slot_name));
547 if (n & 1) /* odd or -1 */
548 SCM_MISC_ERROR ("class contains bogus slot definition: ~S",
549 scm_list_1 (slot_name));
550 tmp = scm_i_get_keyword (k_init_keyword,
551 SCM_CDR (slot_name),
552 n,
553 0,
554 FUNC_NAME);
555 slot_name = SCM_CAR (slot_name);
556 if (tmp)
557 {
558 /* an initarg was provided for this slot */
559 if (!scm_is_keyword (tmp))
560 SCM_MISC_ERROR ("initarg must be a keyword. It was ~S",
561 scm_list_1 (tmp));
562 slot_value = scm_i_get_keyword (tmp,
563 initargs,
564 n_initargs,
565 0,
566 FUNC_NAME);
567 }
568 }
569
570 if (slot_value)
571 /* set slot to provided value */
572 set_slot_value (class, obj, SCM_CAR (get_n_set), slot_value);
573 else
574 {
575 /* set slot to its :init-form if it exists */
576 tmp = SCM_CADAR (get_n_set);
577 if (scm_is_true (tmp))
578 {
579 slot_value = get_slot_value (class, obj, SCM_CAR (get_n_set));
580 if (SCM_GOOPS_UNBOUNDP (slot_value))
581 {
582 SCM env = SCM_EXTEND_ENV (SCM_EOL, SCM_EOL, SCM_ENV (tmp));
583 set_slot_value (class,
584 obj,
585 SCM_CAR (get_n_set),
586 scm_eval_body (SCM_CLOSURE_BODY (tmp), env));
587 }
588 }
589 }
590 }
591
592 return obj;
593 }
594 #undef FUNC_NAME
595
596 /* NOTE: The following macros are interdependent with code
597 * in goops.scm:compute-getters-n-setters
598 */
599 #define SCM_GNS_INSTANCE_ALLOCATED_P(gns) \
600 (SCM_I_INUMP (SCM_CDDR (gns)) \
601 || (scm_is_pair (SCM_CDDR (gns)) \
602 && scm_is_pair (SCM_CDDDR (gns)) \
603 && scm_is_pair (SCM_CDDDDR (gns))))
604 #define SCM_GNS_INDEX(gns) \
605 (SCM_I_INUMP (SCM_CDDR (gns)) \
606 ? SCM_I_INUM (SCM_CDDR (gns)) \
607 : scm_to_long (SCM_CAR (SCM_CDDDDR (gns))))
608 #define SCM_GNS_SIZE(gns) \
609 (SCM_I_INUMP (SCM_CDDR (gns)) \
610 ? 1 \
611 : scm_to_long (SCM_CADR (SCM_CDDDDR (gns))))
612
613 SCM_KEYWORD (k_class, "class");
614 SCM_KEYWORD (k_allocation, "allocation");
615 SCM_KEYWORD (k_instance, "instance");
616
617 SCM_DEFINE (scm_sys_prep_layout_x, "%prep-layout!", 1, 0, 0,
618 (SCM class),
619 "")
620 #define FUNC_NAME s_scm_sys_prep_layout_x
621 {
622 SCM slots, getters_n_setters, nfields;
623 unsigned long int n, i;
624 char *s;
625 SCM layout;
626
627 SCM_VALIDATE_INSTANCE (1, class);
628 slots = SCM_SLOT (class, scm_si_slots);
629 getters_n_setters = SCM_SLOT (class, scm_si_getters_n_setters);
630 nfields = SCM_SLOT (class, scm_si_nfields);
631 if (!SCM_I_INUMP (nfields) || SCM_I_INUM (nfields) < 0)
632 SCM_MISC_ERROR ("bad value in nfields slot: ~S",
633 scm_list_1 (nfields));
634 n = 2 * SCM_I_INUM (nfields);
635 if (n < sizeof (SCM_CLASS_CLASS_LAYOUT) - 1
636 && SCM_SUBCLASSP (class, scm_class_class))
637 SCM_MISC_ERROR ("class object doesn't have enough fields: ~S",
638 scm_list_1 (nfields));
639
640 layout = scm_i_make_string (n, &s);
641 i = 0;
642 while (scm_is_pair (getters_n_setters))
643 {
644 if (SCM_GNS_INSTANCE_ALLOCATED_P (SCM_CAR (getters_n_setters)))
645 {
646 SCM type;
647 int len, index, size;
648 char p, a;
649
650 if (i >= n || !scm_is_pair (slots))
651 goto inconsistent;
652
653 /* extract slot type */
654 len = scm_ilength (SCM_CDAR (slots));
655 type = scm_i_get_keyword (k_class, SCM_CDAR (slots),
656 len, SCM_BOOL_F, FUNC_NAME);
657 /* determine slot GC protection and access mode */
658 if (scm_is_false (type))
659 {
660 p = 'p';
661 a = 'w';
662 }
663 else
664 {
665 if (!SCM_CLASSP (type))
666 SCM_MISC_ERROR ("bad slot class", SCM_EOL);
667 else if (SCM_SUBCLASSP (type, scm_class_foreign_slot))
668 {
669 if (SCM_SUBCLASSP (type, scm_class_self))
670 p = 's';
671 else if (SCM_SUBCLASSP (type, scm_class_protected))
672 p = 'p';
673 else
674 p = 'u';
675
676 if (SCM_SUBCLASSP (type, scm_class_opaque))
677 a = 'o';
678 else if (SCM_SUBCLASSP (type, scm_class_read_only))
679 a = 'r';
680 else
681 a = 'w';
682 }
683 else
684 {
685 p = 'p';
686 a = 'w';
687 }
688 }
689
690 index = SCM_GNS_INDEX (SCM_CAR (getters_n_setters));
691 if (index != (i >> 1))
692 goto inconsistent;
693 size = SCM_GNS_SIZE (SCM_CAR (getters_n_setters));
694 while (size)
695 {
696 s[i++] = p;
697 s[i++] = a;
698 --size;
699 }
700 }
701 slots = SCM_CDR (slots);
702 getters_n_setters = SCM_CDR (getters_n_setters);
703 }
704 if (!scm_is_null (slots))
705 {
706 inconsistent:
707 SCM_MISC_ERROR ("inconsistent getters-n-setters", SCM_EOL);
708 }
709 SCM_SET_SLOT (class, scm_si_layout, scm_string_to_symbol (layout));
710 return SCM_UNSPECIFIED;
711 }
712 #undef FUNC_NAME
713
714 static void prep_hashsets (SCM);
715
716 SCM_DEFINE (scm_sys_inherit_magic_x, "%inherit-magic!", 2, 0, 0,
717 (SCM class, SCM dsupers),
718 "")
719 #define FUNC_NAME s_scm_sys_inherit_magic_x
720 {
721 SCM ls = dsupers;
722 long flags = 0;
723 SCM_VALIDATE_INSTANCE (1, class);
724 while (!scm_is_null (ls))
725 {
726 SCM_ASSERT (scm_is_pair (ls)
727 && SCM_INSTANCEP (SCM_CAR (ls)),
728 dsupers,
729 SCM_ARG2,
730 FUNC_NAME);
731 flags |= SCM_CLASS_FLAGS (SCM_CAR (ls));
732 ls = SCM_CDR (ls);
733 }
734 flags &= SCM_CLASSF_INHERIT;
735 if (flags & SCM_CLASSF_ENTITY)
736 SCM_SET_CLASS_DESTRUCTOR (class, scm_struct_free_entity);
737 else
738 {
739 long n = SCM_I_INUM (SCM_SLOT (class, scm_si_nfields));
740 #if 0
741 /*
742 * We could avoid calling scm_gc_malloc in the allocation code
743 * (in which case the following two lines are needed). Instead
744 * we make 0-slot instances non-light, so that the light case
745 * can be handled without special cases.
746 */
747 if (n == 0)
748 SCM_SET_CLASS_DESTRUCTOR (class, scm_struct_free_0);
749 #endif
750 if (n > 0 && !(flags & SCM_CLASSF_METACLASS))
751 {
752 /* NOTE: The following depends on scm_struct_i_size. */
753 flags |= SCM_STRUCTF_LIGHT + n * sizeof (SCM); /* use light representation */
754 SCM_SET_CLASS_DESTRUCTOR (class, scm_struct_free_light);
755 }
756 }
757 SCM_SET_CLASS_FLAGS (class, flags);
758
759 prep_hashsets (class);
760
761 return SCM_UNSPECIFIED;
762 }
763 #undef FUNC_NAME
764
765 static void
766 prep_hashsets (SCM class)
767 {
768 unsigned int i;
769
770 for (i = 0; i < 7; ++i)
771 SCM_SET_HASHSET (class, i, scm_c_uniform32 (goops_rstate));
772 }
773
774 /******************************************************************************/
775
776 SCM
777 scm_basic_basic_make_class (SCM class, SCM name, SCM dsupers, SCM dslots)
778 {
779 SCM z, cpl, slots, nfields, g_n_s;
780
781 /* Allocate one instance */
782 z = scm_make_struct (class, SCM_INUM0, SCM_EOL);
783
784 /* Initialize its slots */
785 SCM_SET_SLOT (z, scm_si_direct_supers, dsupers);
786 cpl = compute_cpl (z);
787 slots = build_slots_list (maplist (dslots), cpl);
788 nfields = scm_from_int (scm_ilength (slots));
789 g_n_s = compute_getters_n_setters (slots);
790
791 SCM_SET_SLOT (z, scm_si_name, name);
792 SCM_SET_SLOT (z, scm_si_direct_slots, dslots);
793 SCM_SET_SLOT (z, scm_si_direct_subclasses, SCM_EOL);
794 SCM_SET_SLOT (z, scm_si_direct_methods, SCM_EOL);
795 SCM_SET_SLOT (z, scm_si_cpl, cpl);
796 SCM_SET_SLOT (z, scm_si_slots, slots);
797 SCM_SET_SLOT (z, scm_si_nfields, nfields);
798 SCM_SET_SLOT (z, scm_si_getters_n_setters, g_n_s);
799 SCM_SET_SLOT (z, scm_si_redefined, SCM_BOOL_F);
800 SCM_SET_SLOT (z, scm_si_environment,
801 scm_top_level_env (SCM_TOP_LEVEL_LOOKUP_CLOSURE));
802
803 /* Add this class in the direct-subclasses slot of dsupers */
804 {
805 SCM tmp;
806 for (tmp = dsupers; !scm_is_null (tmp); tmp = SCM_CDR (tmp))
807 SCM_SET_SLOT (SCM_CAR (tmp), scm_si_direct_subclasses,
808 scm_cons (z, SCM_SLOT (SCM_CAR (tmp),
809 scm_si_direct_subclasses)));
810 }
811
812 /* Support for the underlying structs: */
813 SCM_SET_CLASS_FLAGS (z, (class == scm_class_entity_class
814 ? (SCM_CLASSF_GOOPS_OR_VALID
815 | SCM_CLASSF_OPERATOR
816 | SCM_CLASSF_ENTITY)
817 : class == scm_class_operator_class
818 ? SCM_CLASSF_GOOPS_OR_VALID | SCM_CLASSF_OPERATOR
819 : SCM_CLASSF_GOOPS_OR_VALID));
820 return z;
821 }
822
823 SCM
824 scm_basic_make_class (SCM class, SCM name, SCM dsupers, SCM dslots)
825 {
826 SCM z = scm_basic_basic_make_class (class, name, dsupers, dslots);
827 scm_sys_inherit_magic_x (z, dsupers);
828 scm_sys_prep_layout_x (z);
829 return z;
830 }
831
832 /******************************************************************************/
833
834 SCM_SYMBOL (sym_layout, "layout");
835 SCM_SYMBOL (sym_vcell, "vcell");
836 SCM_SYMBOL (sym_vtable, "vtable");
837 SCM_SYMBOL (sym_print, "print");
838 SCM_SYMBOL (sym_procedure, "procedure");
839 SCM_SYMBOL (sym_setter, "setter");
840 SCM_SYMBOL (sym_redefined, "redefined");
841 SCM_SYMBOL (sym_h0, "h0");
842 SCM_SYMBOL (sym_h1, "h1");
843 SCM_SYMBOL (sym_h2, "h2");
844 SCM_SYMBOL (sym_h3, "h3");
845 SCM_SYMBOL (sym_h4, "h4");
846 SCM_SYMBOL (sym_h5, "h5");
847 SCM_SYMBOL (sym_h6, "h6");
848 SCM_SYMBOL (sym_h7, "h7");
849 SCM_SYMBOL (sym_name, "name");
850 SCM_SYMBOL (sym_direct_supers, "direct-supers");
851 SCM_SYMBOL (sym_direct_slots, "direct-slots");
852 SCM_SYMBOL (sym_direct_subclasses, "direct-subclasses");
853 SCM_SYMBOL (sym_direct_methods, "direct-methods");
854 SCM_SYMBOL (sym_cpl, "cpl");
855 SCM_SYMBOL (sym_default_slot_definition_class, "default-slot-definition-class");
856 SCM_SYMBOL (sym_slots, "slots");
857 SCM_SYMBOL (sym_getters_n_setters, "getters-n-setters");
858 SCM_SYMBOL (sym_keyword_access, "keyword-access");
859 SCM_SYMBOL (sym_nfields, "nfields");
860 SCM_SYMBOL (sym_environment, "environment");
861
862
863 static SCM
864 build_class_class_slots ()
865 {
866 return scm_list_n (
867 scm_list_3 (sym_layout, k_class, scm_class_protected_read_only),
868 scm_list_3 (sym_vtable, k_class, scm_class_self),
869 scm_list_1 (sym_print),
870 scm_list_3 (sym_procedure, k_class, scm_class_protected_opaque),
871 scm_list_3 (sym_setter, k_class, scm_class_protected_opaque),
872 scm_list_1 (sym_redefined),
873 scm_list_3 (sym_h0, k_class, scm_class_int),
874 scm_list_3 (sym_h1, k_class, scm_class_int),
875 scm_list_3 (sym_h2, k_class, scm_class_int),
876 scm_list_3 (sym_h3, k_class, scm_class_int),
877 scm_list_3 (sym_h4, k_class, scm_class_int),
878 scm_list_3 (sym_h5, k_class, scm_class_int),
879 scm_list_3 (sym_h6, k_class, scm_class_int),
880 scm_list_3 (sym_h7, k_class, scm_class_int),
881 scm_list_1 (sym_name),
882 scm_list_1 (sym_direct_supers),
883 scm_list_1 (sym_direct_slots),
884 scm_list_1 (sym_direct_subclasses),
885 scm_list_1 (sym_direct_methods),
886 scm_list_1 (sym_cpl),
887 scm_list_1 (sym_default_slot_definition_class),
888 scm_list_1 (sym_slots),
889 scm_list_1 (sym_getters_n_setters),
890 scm_list_1 (sym_keyword_access),
891 scm_list_1 (sym_nfields),
892 scm_list_1 (sym_environment),
893 SCM_UNDEFINED);
894 }
895
896 static void
897 create_basic_classes (void)
898 {
899 /* SCM slots_of_class = build_class_class_slots (); */
900
901 /**** <scm_class_class> ****/
902 SCM cs = scm_from_locale_string (SCM_CLASS_CLASS_LAYOUT
903 + 2 * scm_vtable_offset_user);
904 SCM name = scm_from_locale_symbol ("<class>");
905 scm_class_class = scm_permanent_object (scm_make_vtable_vtable (cs,
906 SCM_INUM0,
907 SCM_EOL));
908 SCM_SET_CLASS_FLAGS (scm_class_class, (SCM_CLASSF_GOOPS_OR_VALID
909 | SCM_CLASSF_METACLASS));
910
911 SCM_SET_SLOT (scm_class_class, scm_si_name, name);
912 SCM_SET_SLOT (scm_class_class, scm_si_direct_supers, SCM_EOL); /* will be changed */
913 /* SCM_SET_SLOT (scm_class_class, scm_si_direct_slots, slots_of_class); */
914 SCM_SET_SLOT (scm_class_class, scm_si_direct_subclasses, SCM_EOL);
915 SCM_SET_SLOT (scm_class_class, scm_si_direct_methods, SCM_EOL);
916 SCM_SET_SLOT (scm_class_class, scm_si_cpl, SCM_EOL); /* will be changed */
917 /* SCM_SET_SLOT (scm_class_class, scm_si_slots, slots_of_class); */
918 SCM_SET_SLOT (scm_class_class, scm_si_nfields, scm_from_int (SCM_N_CLASS_SLOTS));
919 /* SCM_SET_SLOT (scm_class_class, scm_si_getters_n_setters,
920 compute_getters_n_setters (slots_of_class)); */
921 SCM_SET_SLOT (scm_class_class, scm_si_redefined, SCM_BOOL_F);
922 SCM_SET_SLOT (scm_class_class, scm_si_environment,
923 scm_top_level_env (SCM_TOP_LEVEL_LOOKUP_CLOSURE));
924
925 prep_hashsets (scm_class_class);
926
927 DEFVAR(name, scm_class_class);
928
929 /**** <scm_class_top> ****/
930 name = scm_from_locale_symbol ("<top>");
931 scm_class_top = scm_permanent_object (scm_basic_make_class (scm_class_class,
932 name,
933 SCM_EOL,
934 SCM_EOL));
935
936 DEFVAR(name, scm_class_top);
937
938 /**** <scm_class_object> ****/
939 name = scm_from_locale_symbol ("<object>");
940 scm_class_object = scm_permanent_object (scm_basic_make_class (scm_class_class,
941 name,
942 scm_list_1 (scm_class_top),
943 SCM_EOL));
944
945 DEFVAR (name, scm_class_object);
946
947 /* <top> <object> and <class> were partially initialized. Correct them here */
948 SCM_SET_SLOT (scm_class_object, scm_si_direct_subclasses, scm_list_1 (scm_class_class));
949
950 SCM_SET_SLOT (scm_class_class, scm_si_direct_supers, scm_list_1 (scm_class_object));
951 SCM_SET_SLOT (scm_class_class, scm_si_cpl, scm_list_3 (scm_class_class, scm_class_object, scm_class_top));
952 }
953
954 /******************************************************************************/
955
956 SCM_DEFINE (scm_instance_p, "instance?", 1, 0, 0,
957 (SCM obj),
958 "Return @code{#t} if @var{obj} is an instance.")
959 #define FUNC_NAME s_scm_instance_p
960 {
961 return scm_from_bool (SCM_INSTANCEP (obj));
962 }
963 #undef FUNC_NAME
964
965
966 /******************************************************************************
967 *
968 * Meta object accessors
969 *
970 ******************************************************************************/
971 SCM_DEFINE (scm_class_name, "class-name", 1, 0, 0,
972 (SCM obj),
973 "Return the class name of @var{obj}.")
974 #define FUNC_NAME s_scm_class_name
975 {
976 SCM_VALIDATE_CLASS (1, obj);
977 return scm_slot_ref (obj, sym_name);
978 }
979 #undef FUNC_NAME
980
981 SCM_DEFINE (scm_class_direct_supers, "class-direct-supers", 1, 0, 0,
982 (SCM obj),
983 "Return the direct superclasses of the class @var{obj}.")
984 #define FUNC_NAME s_scm_class_direct_supers
985 {
986 SCM_VALIDATE_CLASS (1, obj);
987 return scm_slot_ref (obj, sym_direct_supers);
988 }
989 #undef FUNC_NAME
990
991 SCM_DEFINE (scm_class_direct_slots, "class-direct-slots", 1, 0, 0,
992 (SCM obj),
993 "Return the direct slots of the class @var{obj}.")
994 #define FUNC_NAME s_scm_class_direct_slots
995 {
996 SCM_VALIDATE_CLASS (1, obj);
997 return scm_slot_ref (obj, sym_direct_slots);
998 }
999 #undef FUNC_NAME
1000
1001 SCM_DEFINE (scm_class_direct_subclasses, "class-direct-subclasses", 1, 0, 0,
1002 (SCM obj),
1003 "Return the direct subclasses of the class @var{obj}.")
1004 #define FUNC_NAME s_scm_class_direct_subclasses
1005 {
1006 SCM_VALIDATE_CLASS (1, obj);
1007 return scm_slot_ref(obj, sym_direct_subclasses);
1008 }
1009 #undef FUNC_NAME
1010
1011 SCM_DEFINE (scm_class_direct_methods, "class-direct-methods", 1, 0, 0,
1012 (SCM obj),
1013 "Return the direct methods of the class @var{obj}")
1014 #define FUNC_NAME s_scm_class_direct_methods
1015 {
1016 SCM_VALIDATE_CLASS (1, obj);
1017 return scm_slot_ref (obj, sym_direct_methods);
1018 }
1019 #undef FUNC_NAME
1020
1021 SCM_DEFINE (scm_class_precedence_list, "class-precedence-list", 1, 0, 0,
1022 (SCM obj),
1023 "Return the class precedence list of the class @var{obj}.")
1024 #define FUNC_NAME s_scm_class_precedence_list
1025 {
1026 SCM_VALIDATE_CLASS (1, obj);
1027 return scm_slot_ref (obj, sym_cpl);
1028 }
1029 #undef FUNC_NAME
1030
1031 SCM_DEFINE (scm_class_slots, "class-slots", 1, 0, 0,
1032 (SCM obj),
1033 "Return the slot list of the class @var{obj}.")
1034 #define FUNC_NAME s_scm_class_slots
1035 {
1036 SCM_VALIDATE_CLASS (1, obj);
1037 return scm_slot_ref (obj, sym_slots);
1038 }
1039 #undef FUNC_NAME
1040
1041 SCM_DEFINE (scm_class_environment, "class-environment", 1, 0, 0,
1042 (SCM obj),
1043 "Return the environment of the class @var{obj}.")
1044 #define FUNC_NAME s_scm_class_environment
1045 {
1046 SCM_VALIDATE_CLASS (1, obj);
1047 return scm_slot_ref(obj, sym_environment);
1048 }
1049 #undef FUNC_NAME
1050
1051
1052 SCM_DEFINE (scm_generic_function_name, "generic-function-name", 1, 0, 0,
1053 (SCM obj),
1054 "Return the name of the generic function @var{obj}.")
1055 #define FUNC_NAME s_scm_generic_function_name
1056 {
1057 SCM_VALIDATE_GENERIC (1, obj);
1058 return scm_procedure_property (obj, scm_sym_name);
1059 }
1060 #undef FUNC_NAME
1061
1062 SCM_SYMBOL (sym_methods, "methods");
1063 SCM_SYMBOL (sym_extended_by, "extended-by");
1064 SCM_SYMBOL (sym_extends, "extends");
1065
1066 static
1067 SCM fold_downward_gf_methods (SCM method_lists, SCM gf)
1068 {
1069 SCM gfs = scm_slot_ref (gf, sym_extended_by);
1070 method_lists = scm_cons (scm_slot_ref (gf, sym_methods), method_lists);
1071 while (!scm_is_null (gfs))
1072 {
1073 method_lists = fold_downward_gf_methods (method_lists, SCM_CAR (gfs));
1074 gfs = SCM_CDR (gfs);
1075 }
1076 return method_lists;
1077 }
1078
1079 static
1080 SCM fold_upward_gf_methods (SCM method_lists, SCM gf)
1081 {
1082 if (SCM_IS_A_P (gf, scm_class_extended_generic))
1083 {
1084 SCM gfs = scm_slot_ref (gf, sym_extends);
1085 while (!scm_is_null (gfs))
1086 {
1087 SCM methods = scm_slot_ref (SCM_CAR (gfs), sym_methods);
1088 method_lists = fold_upward_gf_methods (scm_cons (methods,
1089 method_lists),
1090 SCM_CAR (gfs));
1091 gfs = SCM_CDR (gfs);
1092 }
1093 }
1094 return method_lists;
1095 }
1096
1097 SCM_DEFINE (scm_generic_function_methods, "generic-function-methods", 1, 0, 0,
1098 (SCM obj),
1099 "Return the methods of the generic function @var{obj}.")
1100 #define FUNC_NAME s_scm_generic_function_methods
1101 {
1102 SCM methods;
1103 SCM_VALIDATE_GENERIC (1, obj);
1104 methods = fold_upward_gf_methods (SCM_EOL, obj);
1105 methods = fold_downward_gf_methods (methods, obj);
1106 return scm_append (methods);
1107 }
1108 #undef FUNC_NAME
1109
1110 SCM_DEFINE (scm_method_generic_function, "method-generic-function", 1, 0, 0,
1111 (SCM obj),
1112 "Return the generic function for the method @var{obj}.")
1113 #define FUNC_NAME s_scm_method_generic_function
1114 {
1115 SCM_VALIDATE_METHOD (1, obj);
1116 return scm_slot_ref (obj, scm_from_locale_symbol ("generic-function"));
1117 }
1118 #undef FUNC_NAME
1119
1120 SCM_DEFINE (scm_method_specializers, "method-specializers", 1, 0, 0,
1121 (SCM obj),
1122 "Return specializers of the method @var{obj}.")
1123 #define FUNC_NAME s_scm_method_specializers
1124 {
1125 SCM_VALIDATE_METHOD (1, obj);
1126 return scm_slot_ref (obj, scm_from_locale_symbol ("specializers"));
1127 }
1128 #undef FUNC_NAME
1129
1130 SCM_DEFINE (scm_method_procedure, "method-procedure", 1, 0, 0,
1131 (SCM obj),
1132 "Return the procedure of the method @var{obj}.")
1133 #define FUNC_NAME s_scm_method_procedure
1134 {
1135 SCM_VALIDATE_METHOD (1, obj);
1136 return scm_slot_ref (obj, sym_procedure);
1137 }
1138 #undef FUNC_NAME
1139
1140 SCM_DEFINE (scm_accessor_method_slot_definition, "accessor-method-slot-definition", 1, 0, 0,
1141 (SCM obj),
1142 "Return the slot definition of the accessor @var{obj}.")
1143 #define FUNC_NAME s_scm_accessor_method_slot_definition
1144 {
1145 SCM_VALIDATE_ACCESSOR (1, obj);
1146 return scm_slot_ref (obj, scm_from_locale_symbol ("slot-definition"));
1147 }
1148 #undef FUNC_NAME
1149
1150 SCM_DEFINE (scm_sys_tag_body, "%tag-body", 1, 0, 0,
1151 (SCM body),
1152 "Internal GOOPS magic---don't use this function!")
1153 #define FUNC_NAME s_scm_sys_tag_body
1154 {
1155 return scm_cons (SCM_IM_LAMBDA, body);
1156 }
1157 #undef FUNC_NAME
1158
1159 /******************************************************************************
1160 *
1161 * S l o t a c c e s s
1162 *
1163 ******************************************************************************/
1164
1165 SCM_DEFINE (scm_make_unbound, "make-unbound", 0, 0, 0,
1166 (),
1167 "Return the unbound value.")
1168 #define FUNC_NAME s_scm_make_unbound
1169 {
1170 return SCM_GOOPS_UNBOUND;
1171 }
1172 #undef FUNC_NAME
1173
1174 SCM_DEFINE (scm_unbound_p, "unbound?", 1, 0, 0,
1175 (SCM obj),
1176 "Return @code{#t} if @var{obj} is unbound.")
1177 #define FUNC_NAME s_scm_unbound_p
1178 {
1179 return SCM_GOOPS_UNBOUNDP (obj) ? SCM_BOOL_T : SCM_BOOL_F;
1180 }
1181 #undef FUNC_NAME
1182
1183 SCM_DEFINE (scm_assert_bound, "assert-bound", 2, 0, 0,
1184 (SCM value, SCM obj),
1185 "Return @var{value} if it is bound, and invoke the\n"
1186 "@var{slot-unbound} method of @var{obj} if it is not.")
1187 #define FUNC_NAME s_scm_assert_bound
1188 {
1189 if (SCM_GOOPS_UNBOUNDP (value))
1190 return CALL_GF1 ("slot-unbound", obj);
1191 return value;
1192 }
1193 #undef FUNC_NAME
1194
1195 SCM_DEFINE (scm_at_assert_bound_ref, "@assert-bound-ref", 2, 0, 0,
1196 (SCM obj, SCM index),
1197 "Like @code{assert-bound}, but use @var{index} for accessing\n"
1198 "the value from @var{obj}.")
1199 #define FUNC_NAME s_scm_at_assert_bound_ref
1200 {
1201 SCM value = SCM_SLOT (obj, scm_to_int (index));
1202 if (SCM_GOOPS_UNBOUNDP (value))
1203 return CALL_GF1 ("slot-unbound", obj);
1204 return value;
1205 }
1206 #undef FUNC_NAME
1207
1208 SCM_DEFINE (scm_sys_fast_slot_ref, "%fast-slot-ref", 2, 0, 0,
1209 (SCM obj, SCM index),
1210 "Return the slot value with index @var{index} from @var{obj}.")
1211 #define FUNC_NAME s_scm_sys_fast_slot_ref
1212 {
1213 unsigned long int i;
1214
1215 SCM_VALIDATE_INSTANCE (1, obj);
1216 i = scm_to_unsigned_integer (index, 0, SCM_NUMBER_OF_SLOTS(obj)-1);
1217 return SCM_SLOT (obj, i);
1218 }
1219 #undef FUNC_NAME
1220
1221 SCM_DEFINE (scm_sys_fast_slot_set_x, "%fast-slot-set!", 3, 0, 0,
1222 (SCM obj, SCM index, SCM value),
1223 "Set the slot with index @var{index} in @var{obj} to\n"
1224 "@var{value}.")
1225 #define FUNC_NAME s_scm_sys_fast_slot_set_x
1226 {
1227 unsigned long int i;
1228
1229 SCM_VALIDATE_INSTANCE (1, obj);
1230 i = scm_to_unsigned_integer (index, 0, SCM_NUMBER_OF_SLOTS(obj)-1);
1231
1232 SCM_SET_SLOT (obj, i, value);
1233
1234 return SCM_UNSPECIFIED;
1235 }
1236 #undef FUNC_NAME
1237
1238
1239 SCM_SYNTAX (s_atslot_ref, "@slot-ref", scm_i_makbimacro, scm_m_atslot_ref);
1240 SCM_SYNTAX (s_atslot_set_x, "@slot-set!", scm_i_makbimacro, scm_m_atslot_set_x);
1241
1242
1243 /** Utilities **/
1244
1245 /* In the future, this function will return the effective slot
1246 * definition associated with SLOT_NAME. Now it just returns some of
1247 * the information which will be stored in the effective slot
1248 * definition.
1249 */
1250
1251 static SCM
1252 slot_definition_using_name (SCM class, SCM slot_name)
1253 {
1254 register SCM slots = SCM_SLOT (class, scm_si_getters_n_setters);
1255 for (; !scm_is_null (slots); slots = SCM_CDR (slots))
1256 if (SCM_CAAR (slots) == slot_name)
1257 return SCM_CAR (slots);
1258 return SCM_BOOL_F;
1259 }
1260
1261 static SCM
1262 get_slot_value (SCM class SCM_UNUSED, SCM obj, SCM slotdef)
1263 #define FUNC_NAME "%get-slot-value"
1264 {
1265 SCM access = SCM_CDDR (slotdef);
1266 /* Two cases here:
1267 * - access is an integer (the offset of this slot in the slots vector)
1268 * - otherwise (car access) is the getter function to apply
1269 *
1270 * Instances have never more than SCM_MOST_POSITIVE_FIXNUM slots, so
1271 * we can just assume fixnums here.
1272 */
1273 if (SCM_I_INUMP (access))
1274 /* Don't poke at the slots directly, because scm_struct_ref handles the
1275 access bits for us. */
1276 return scm_struct_ref (obj, access);
1277 else
1278 {
1279 /* We must evaluate (apply (car access) (list obj))
1280 * where (car access) is known to be a closure of arity 1 */
1281 register SCM code, env;
1282
1283 code = SCM_CAR (access);
1284 if (!SCM_CLOSUREP (code))
1285 return SCM_SUBRF (code) (obj);
1286 env = SCM_EXTEND_ENV (SCM_CLOSURE_FORMALS (code),
1287 scm_list_1 (obj),
1288 SCM_ENV (code));
1289 /* Evaluate the closure body */
1290 return scm_eval_body (SCM_CLOSURE_BODY (code), env);
1291 }
1292 }
1293 #undef FUNC_NAME
1294
1295 static SCM
1296 get_slot_value_using_name (SCM class, SCM obj, SCM slot_name)
1297 {
1298 SCM slotdef = slot_definition_using_name (class, slot_name);
1299 if (scm_is_true (slotdef))
1300 return get_slot_value (class, obj, slotdef);
1301 else
1302 return CALL_GF3 ("slot-missing", class, obj, slot_name);
1303 }
1304
1305 static SCM
1306 set_slot_value (SCM class SCM_UNUSED, SCM obj, SCM slotdef, SCM value)
1307 #define FUNC_NAME "%set-slot-value"
1308 {
1309 SCM access = SCM_CDDR (slotdef);
1310 /* Two cases here:
1311 * - access is an integer (the offset of this slot in the slots vector)
1312 * - otherwise (cadr access) is the setter function to apply
1313 *
1314 * Instances have never more than SCM_MOST_POSITIVE_FIXNUM slots, so
1315 * we can just assume fixnums here.
1316 */
1317 if (SCM_I_INUMP (access))
1318 /* obey permissions bits via going through struct-set! */
1319 scm_struct_set_x (obj, access, value);
1320 else
1321 {
1322 /* We must evaluate (apply (cadr l) (list obj value))
1323 * where (cadr l) is known to be a closure of arity 2 */
1324 register SCM code, env;
1325
1326 code = SCM_CADR (access);
1327 if (!SCM_CLOSUREP (code))
1328 SCM_SUBRF (code) (obj, value);
1329 else
1330 {
1331 env = SCM_EXTEND_ENV (SCM_CLOSURE_FORMALS (code),
1332 scm_list_2 (obj, value),
1333 SCM_ENV (code));
1334 /* Evaluate the closure body */
1335 scm_eval_body (SCM_CLOSURE_BODY (code), env);
1336 }
1337 }
1338 return SCM_UNSPECIFIED;
1339 }
1340 #undef FUNC_NAME
1341
1342 static SCM
1343 set_slot_value_using_name (SCM class, SCM obj, SCM slot_name, SCM value)
1344 {
1345 SCM slotdef = slot_definition_using_name (class, slot_name);
1346 if (scm_is_true (slotdef))
1347 return set_slot_value (class, obj, slotdef, value);
1348 else
1349 return CALL_GF4 ("slot-missing", class, obj, slot_name, value);
1350 }
1351
1352 static SCM
1353 test_slot_existence (SCM class SCM_UNUSED, SCM obj, SCM slot_name)
1354 {
1355 register SCM l;
1356
1357 for (l = SCM_ACCESSORS_OF (obj); !scm_is_null (l); l = SCM_CDR (l))
1358 if (scm_is_eq (SCM_CAAR (l), slot_name))
1359 return SCM_BOOL_T;
1360
1361 return SCM_BOOL_F;
1362 }
1363
1364 /* ======================================== */
1365
1366 SCM_DEFINE (scm_slot_ref_using_class, "slot-ref-using-class", 3, 0, 0,
1367 (SCM class, SCM obj, SCM slot_name),
1368 "")
1369 #define FUNC_NAME s_scm_slot_ref_using_class
1370 {
1371 SCM res;
1372
1373 SCM_VALIDATE_CLASS (1, class);
1374 SCM_VALIDATE_INSTANCE (2, obj);
1375 SCM_VALIDATE_SYMBOL (3, slot_name);
1376
1377 res = get_slot_value_using_name (class, obj, slot_name);
1378 if (SCM_GOOPS_UNBOUNDP (res))
1379 return CALL_GF3 ("slot-unbound", class, obj, slot_name);
1380 return res;
1381 }
1382 #undef FUNC_NAME
1383
1384
1385 SCM_DEFINE (scm_slot_set_using_class_x, "slot-set-using-class!", 4, 0, 0,
1386 (SCM class, SCM obj, SCM slot_name, SCM value),
1387 "")
1388 #define FUNC_NAME s_scm_slot_set_using_class_x
1389 {
1390 SCM_VALIDATE_CLASS (1, class);
1391 SCM_VALIDATE_INSTANCE (2, obj);
1392 SCM_VALIDATE_SYMBOL (3, slot_name);
1393
1394 return set_slot_value_using_name (class, obj, slot_name, value);
1395 }
1396 #undef FUNC_NAME
1397
1398
1399 SCM_DEFINE (scm_slot_bound_using_class_p, "slot-bound-using-class?", 3, 0, 0,
1400 (SCM class, SCM obj, SCM slot_name),
1401 "")
1402 #define FUNC_NAME s_scm_slot_bound_using_class_p
1403 {
1404 SCM_VALIDATE_CLASS (1, class);
1405 SCM_VALIDATE_INSTANCE (2, obj);
1406 SCM_VALIDATE_SYMBOL (3, slot_name);
1407
1408 return (SCM_GOOPS_UNBOUNDP (get_slot_value_using_name (class, obj, slot_name))
1409 ? SCM_BOOL_F
1410 : SCM_BOOL_T);
1411 }
1412 #undef FUNC_NAME
1413
1414 SCM_DEFINE (scm_slot_exists_using_class_p, "slot-exists-using-class?", 3, 0, 0,
1415 (SCM class, SCM obj, SCM slot_name),
1416 "")
1417 #define FUNC_NAME s_scm_slot_exists_using_class_p
1418 {
1419 SCM_VALIDATE_CLASS (1, class);
1420 SCM_VALIDATE_INSTANCE (2, obj);
1421 SCM_VALIDATE_SYMBOL (3, slot_name);
1422 return test_slot_existence (class, obj, slot_name);
1423 }
1424 #undef FUNC_NAME
1425
1426
1427 /* ======================================== */
1428
1429 SCM_DEFINE (scm_slot_ref, "slot-ref", 2, 0, 0,
1430 (SCM obj, SCM slot_name),
1431 "Return the value from @var{obj}'s slot with the name\n"
1432 "@var{slot_name}.")
1433 #define FUNC_NAME s_scm_slot_ref
1434 {
1435 SCM res, class;
1436
1437 SCM_VALIDATE_INSTANCE (1, obj);
1438 TEST_CHANGE_CLASS (obj, class);
1439
1440 res = get_slot_value_using_name (class, obj, slot_name);
1441 if (SCM_GOOPS_UNBOUNDP (res))
1442 return CALL_GF3 ("slot-unbound", class, obj, slot_name);
1443 return res;
1444 }
1445 #undef FUNC_NAME
1446
1447 SCM_DEFINE (scm_slot_set_x, "slot-set!", 3, 0, 0,
1448 (SCM obj, SCM slot_name, SCM value),
1449 "Set the slot named @var{slot_name} of @var{obj} to @var{value}.")
1450 #define FUNC_NAME s_scm_slot_set_x
1451 {
1452 SCM class;
1453
1454 SCM_VALIDATE_INSTANCE (1, obj);
1455 TEST_CHANGE_CLASS(obj, class);
1456
1457 return set_slot_value_using_name (class, obj, slot_name, value);
1458 }
1459 #undef FUNC_NAME
1460
1461 const char *scm_s_slot_set_x = s_scm_slot_set_x;
1462
1463 SCM_DEFINE (scm_slot_bound_p, "slot-bound?", 2, 0, 0,
1464 (SCM obj, SCM slot_name),
1465 "Return @code{#t} if the slot named @var{slot_name} of @var{obj}\n"
1466 "is bound.")
1467 #define FUNC_NAME s_scm_slot_bound_p
1468 {
1469 SCM class;
1470
1471 SCM_VALIDATE_INSTANCE (1, obj);
1472 TEST_CHANGE_CLASS(obj, class);
1473
1474 return (SCM_GOOPS_UNBOUNDP (get_slot_value_using_name (class,
1475 obj,
1476 slot_name))
1477 ? SCM_BOOL_F
1478 : SCM_BOOL_T);
1479 }
1480 #undef FUNC_NAME
1481
1482 SCM_DEFINE (scm_slot_exists_p, "slot-exists?", 2, 0, 0,
1483 (SCM obj, SCM slot_name),
1484 "Return @code{#t} if @var{obj} has a slot named @var{slot_name}.")
1485 #define FUNC_NAME s_scm_slot_exists_p
1486 {
1487 SCM class;
1488
1489 SCM_VALIDATE_INSTANCE (1, obj);
1490 SCM_VALIDATE_SYMBOL (2, slot_name);
1491 TEST_CHANGE_CLASS (obj, class);
1492
1493 return test_slot_existence (class, obj, slot_name);
1494 }
1495 #undef FUNC_NAME
1496
1497
1498 /******************************************************************************
1499 *
1500 * %allocate-instance (the low level instance allocation primitive)
1501 *
1502 ******************************************************************************/
1503
1504 static void clear_method_cache (SCM);
1505
1506 static SCM
1507 wrap_init (SCM class, SCM *m, long n)
1508 {
1509 long i;
1510 scm_t_bits slayout = SCM_STRUCT_DATA (class)[scm_vtable_index_layout];
1511 const char *layout = scm_i_symbol_chars (SCM_PACK (slayout));
1512
1513 /* Set all SCM-holding slots to unbound */
1514 for (i = 0; i < n; i++)
1515 if (layout[i*2] == 'p')
1516 m[i] = SCM_GOOPS_UNBOUND;
1517 else
1518 m[i] = 0;
1519
1520 return scm_double_cell ((((scm_t_bits) SCM_STRUCT_DATA (class))
1521 | scm_tc3_struct),
1522 (scm_t_bits) m, 0, 0);
1523 }
1524
1525 SCM_DEFINE (scm_sys_allocate_instance, "%allocate-instance", 2, 0, 0,
1526 (SCM class, SCM initargs),
1527 "Create a new instance of class @var{class} and initialize it\n"
1528 "from the arguments @var{initargs}.")
1529 #define FUNC_NAME s_scm_sys_allocate_instance
1530 {
1531 SCM *m;
1532 long n;
1533
1534 SCM_VALIDATE_CLASS (1, class);
1535
1536 /* Most instances */
1537 if (SCM_CLASS_FLAGS (class) & SCM_STRUCTF_LIGHT)
1538 {
1539 n = SCM_I_INUM (SCM_SLOT (class, scm_si_nfields));
1540 m = (SCM *) scm_gc_malloc (n * sizeof (SCM), "struct");
1541 return wrap_init (class, m, n);
1542 }
1543
1544 /* Foreign objects */
1545 if (SCM_CLASS_FLAGS (class) & SCM_CLASSF_FOREIGN)
1546 return scm_make_foreign_object (class, initargs);
1547
1548 n = SCM_I_INUM (SCM_SLOT (class, scm_si_nfields));
1549
1550 /* Entities */
1551 if (SCM_CLASS_FLAGS (class) & SCM_CLASSF_ENTITY)
1552 {
1553 m = (SCM *) scm_alloc_struct (n, scm_struct_entity_n_extra_words,
1554 "entity struct");
1555 m[scm_struct_i_setter] = SCM_BOOL_F;
1556 m[scm_struct_i_procedure] = SCM_BOOL_F;
1557 /* Generic functions */
1558 if (SCM_CLASS_FLAGS (class) & SCM_CLASSF_PURE_GENERIC)
1559 {
1560 SCM gf = wrap_init (class, m, n);
1561 clear_method_cache (gf);
1562 return gf;
1563 }
1564 else
1565 return wrap_init (class, m, n);
1566 }
1567
1568 /* Class objects */
1569 if (SCM_CLASS_FLAGS (class) & SCM_CLASSF_METACLASS)
1570 {
1571 long i;
1572
1573 /* allocate class object */
1574 SCM z = scm_make_struct (class, SCM_INUM0, SCM_EOL);
1575
1576 SCM_SET_SLOT (z, scm_si_print, SCM_GOOPS_UNBOUND);
1577 for (i = scm_si_goops_fields; i < n; i++)
1578 SCM_SET_SLOT (z, i, SCM_GOOPS_UNBOUND);
1579
1580 if (SCM_SUBCLASSP (class, scm_class_entity_class))
1581 SCM_SET_CLASS_FLAGS (z, SCM_CLASSF_OPERATOR | SCM_CLASSF_ENTITY);
1582 else if (SCM_SUBCLASSP (class, scm_class_operator_class))
1583 SCM_SET_CLASS_FLAGS (z, SCM_CLASSF_OPERATOR);
1584
1585 return z;
1586 }
1587
1588 /* Non-light instances */
1589 {
1590 m = (SCM *) scm_alloc_struct (n, scm_struct_n_extra_words, "heavy struct");
1591 return wrap_init (class, m, n);
1592 }
1593 }
1594 #undef FUNC_NAME
1595
1596 SCM_DEFINE (scm_sys_set_object_setter_x, "%set-object-setter!", 2, 0, 0,
1597 (SCM obj, SCM setter),
1598 "")
1599 #define FUNC_NAME s_scm_sys_set_object_setter_x
1600 {
1601 SCM_ASSERT (SCM_STRUCTP (obj)
1602 && ((SCM_CLASS_FLAGS (obj) & SCM_CLASSF_OPERATOR)
1603 || SCM_I_ENTITYP (obj)),
1604 obj,
1605 SCM_ARG1,
1606 FUNC_NAME);
1607 if (SCM_I_ENTITYP (obj))
1608 SCM_SET_ENTITY_SETTER (obj, setter);
1609 else
1610 SCM_OPERATOR_CLASS (obj)->setter = setter;
1611 return SCM_UNSPECIFIED;
1612 }
1613 #undef FUNC_NAME
1614
1615 /******************************************************************************
1616 *
1617 * %modify-instance (used by change-class to modify in place)
1618 *
1619 ******************************************************************************/
1620
1621 SCM_DEFINE (scm_sys_modify_instance, "%modify-instance", 2, 0, 0,
1622 (SCM old, SCM new),
1623 "")
1624 #define FUNC_NAME s_scm_sys_modify_instance
1625 {
1626 SCM_VALIDATE_INSTANCE (1, old);
1627 SCM_VALIDATE_INSTANCE (2, new);
1628
1629 /* Exchange the data contained in old and new. We exchange rather than
1630 * scratch the old value with new to be correct with GC.
1631 * See "Class redefinition protocol above".
1632 */
1633 SCM_CRITICAL_SECTION_START;
1634 {
1635 SCM car = SCM_CAR (old);
1636 SCM cdr = SCM_CDR (old);
1637 SCM_SETCAR (old, SCM_CAR (new));
1638 SCM_SETCDR (old, SCM_CDR (new));
1639 SCM_SETCAR (new, car);
1640 SCM_SETCDR (new, cdr);
1641 }
1642 SCM_CRITICAL_SECTION_END;
1643 return SCM_UNSPECIFIED;
1644 }
1645 #undef FUNC_NAME
1646
1647 SCM_DEFINE (scm_sys_modify_class, "%modify-class", 2, 0, 0,
1648 (SCM old, SCM new),
1649 "")
1650 #define FUNC_NAME s_scm_sys_modify_class
1651 {
1652 SCM_VALIDATE_CLASS (1, old);
1653 SCM_VALIDATE_CLASS (2, new);
1654
1655 SCM_CRITICAL_SECTION_START;
1656 {
1657 SCM car = SCM_CAR (old);
1658 SCM cdr = SCM_CDR (old);
1659 SCM_SETCAR (old, SCM_CAR (new));
1660 SCM_SETCDR (old, SCM_CDR (new));
1661 SCM_STRUCT_DATA (old)[scm_vtable_index_vtable] = SCM_UNPACK (old);
1662 SCM_SETCAR (new, car);
1663 SCM_SETCDR (new, cdr);
1664 SCM_STRUCT_DATA (new)[scm_vtable_index_vtable] = SCM_UNPACK (new);
1665 }
1666 SCM_CRITICAL_SECTION_END;
1667 return SCM_UNSPECIFIED;
1668 }
1669 #undef FUNC_NAME
1670
1671 SCM_DEFINE (scm_sys_invalidate_class, "%invalidate-class", 1, 0, 0,
1672 (SCM class),
1673 "")
1674 #define FUNC_NAME s_scm_sys_invalidate_class
1675 {
1676 SCM_VALIDATE_CLASS (1, class);
1677 SCM_CLEAR_CLASS_FLAGS (class, SCM_CLASSF_GOOPS_VALID);
1678 return SCM_UNSPECIFIED;
1679 }
1680 #undef FUNC_NAME
1681
1682 /* When instances change class, they finally get a new body, but
1683 * before that, they go through purgatory in hell. Odd as it may
1684 * seem, this data structure saves us from eternal suffering in
1685 * infinite recursions.
1686 */
1687
1688 static scm_t_bits **hell;
1689 static long n_hell = 1; /* one place for the evil one himself */
1690 static long hell_size = 4;
1691 static SCM hell_mutex;
1692
1693 static long
1694 burnin (SCM o)
1695 {
1696 long i;
1697 for (i = 1; i < n_hell; ++i)
1698 if (SCM_STRUCT_DATA (o) == hell[i])
1699 return i;
1700 return 0;
1701 }
1702
1703 static void
1704 go_to_hell (void *o)
1705 {
1706 SCM obj = SCM_PACK ((scm_t_bits) o);
1707 scm_lock_mutex (hell_mutex);
1708 if (n_hell == hell_size)
1709 {
1710 long new_size = 2 * hell_size;
1711 hell = scm_realloc (hell, new_size);
1712 hell_size = new_size;
1713 }
1714 hell[n_hell++] = SCM_STRUCT_DATA (obj);
1715 scm_unlock_mutex (hell_mutex);
1716 }
1717
1718 static void
1719 go_to_heaven (void *o)
1720 {
1721 scm_lock_mutex (hell_mutex);
1722 hell[burnin (SCM_PACK ((scm_t_bits) o))] = hell[--n_hell];
1723 scm_unlock_mutex (hell_mutex);
1724 }
1725
1726
1727 SCM_SYMBOL (scm_sym_change_class, "change-class");
1728
1729 static SCM
1730 purgatory (void *args)
1731 {
1732 return scm_apply_0 (GETVAR (scm_sym_change_class),
1733 SCM_PACK ((scm_t_bits) args));
1734 }
1735
1736 /* This function calls the generic function change-class for all
1737 * instances which aren't currently undergoing class change.
1738 */
1739
1740 void
1741 scm_change_object_class (SCM obj, SCM old_class SCM_UNUSED, SCM new_class)
1742 {
1743 if (!burnin (obj))
1744 scm_internal_dynamic_wind (go_to_hell, purgatory, go_to_heaven,
1745 (void *) SCM_UNPACK (scm_list_2 (obj, new_class)),
1746 (void *) SCM_UNPACK (obj));
1747 }
1748
1749 /******************************************************************************
1750 *
1751 * GGGG FFFFF
1752 * G F
1753 * G GG FFF
1754 * G G F
1755 * GGG E N E R I C F U N C T I O N S
1756 *
1757 * This implementation provides
1758 * - generic functions (with class specializers)
1759 * - multi-methods
1760 * - next-method
1761 * - a hard-coded MOP for standard gf, which can be overloaded for non-std gf
1762 *
1763 ******************************************************************************/
1764
1765 SCM_KEYWORD (k_name, "name");
1766
1767 SCM_SYMBOL (sym_no_method, "no-method");
1768
1769 static SCM list_of_no_method;
1770
1771 SCM_GLOBAL_SYMBOL (scm_sym_args, "args");
1772
1773
1774 SCM
1775 scm_make_method_cache (SCM gf)
1776 {
1777 return scm_list_5 (SCM_IM_DISPATCH,
1778 scm_sym_args,
1779 scm_from_int (1),
1780 scm_c_make_vector (SCM_INITIAL_MCACHE_SIZE,
1781 list_of_no_method),
1782 gf);
1783 }
1784
1785 static void
1786 clear_method_cache (SCM gf)
1787 {
1788 SCM cache = scm_make_method_cache (gf);
1789 SCM_SET_ENTITY_PROCEDURE (gf, cache);
1790 SCM_SET_SLOT (gf, scm_si_used_by, SCM_BOOL_F);
1791 }
1792
1793 SCM_DEFINE (scm_sys_invalidate_method_cache_x, "%invalidate-method-cache!", 1, 0, 0,
1794 (SCM gf),
1795 "")
1796 #define FUNC_NAME s_scm_sys_invalidate_method_cache_x
1797 {
1798 SCM used_by;
1799 SCM_ASSERT (SCM_PUREGENERICP (gf), gf, SCM_ARG1, FUNC_NAME);
1800 used_by = SCM_SLOT (gf, scm_si_used_by);
1801 if (scm_is_true (used_by))
1802 {
1803 SCM methods = SCM_SLOT (gf, scm_si_methods);
1804 for (; scm_is_pair (used_by); used_by = SCM_CDR (used_by))
1805 scm_sys_invalidate_method_cache_x (SCM_CAR (used_by));
1806 clear_method_cache (gf);
1807 for (; scm_is_pair (methods); methods = SCM_CDR (methods))
1808 SCM_SET_SLOT (SCM_CAR (methods), scm_si_code_table, SCM_EOL);
1809 }
1810 {
1811 SCM n = SCM_SLOT (gf, scm_si_n_specialized);
1812 /* The sign of n is a flag indicating rest args. */
1813 SCM_SET_MCACHE_N_SPECIALIZED (SCM_ENTITY_PROCEDURE (gf), n);
1814 }
1815 return SCM_UNSPECIFIED;
1816 }
1817 #undef FUNC_NAME
1818
1819 SCM_DEFINE (scm_generic_capability_p, "generic-capability?", 1, 0, 0,
1820 (SCM proc),
1821 "")
1822 #define FUNC_NAME s_scm_generic_capability_p
1823 {
1824 SCM_ASSERT (scm_is_true (scm_procedure_p (proc)),
1825 proc, SCM_ARG1, FUNC_NAME);
1826 return (scm_subr_p (proc) && SCM_SUBR_GENERIC (proc)
1827 ? SCM_BOOL_T
1828 : SCM_BOOL_F);
1829 }
1830 #undef FUNC_NAME
1831
1832 SCM_DEFINE (scm_enable_primitive_generic_x, "enable-primitive-generic!", 0, 0, 1,
1833 (SCM subrs),
1834 "")
1835 #define FUNC_NAME s_scm_enable_primitive_generic_x
1836 {
1837 SCM_VALIDATE_REST_ARGUMENT (subrs);
1838 while (!scm_is_null (subrs))
1839 {
1840 SCM subr = SCM_CAR (subrs);
1841 SCM_ASSERT (scm_subr_p (subr) && SCM_SUBR_GENERIC (subr),
1842 subr, SCM_ARGn, FUNC_NAME);
1843 *SCM_SUBR_GENERIC (subr)
1844 = scm_make (scm_list_3 (scm_class_generic,
1845 k_name,
1846 SCM_SNAME (subr)));
1847 subrs = SCM_CDR (subrs);
1848 }
1849 return SCM_UNSPECIFIED;
1850 }
1851 #undef FUNC_NAME
1852
1853 SCM_DEFINE (scm_primitive_generic_generic, "primitive-generic-generic", 1, 0, 0,
1854 (SCM subr),
1855 "")
1856 #define FUNC_NAME s_scm_primitive_generic_generic
1857 {
1858 if (scm_subr_p (subr) && SCM_SUBR_GENERIC (subr))
1859 {
1860 if (!*SCM_SUBR_GENERIC (subr))
1861 scm_enable_primitive_generic_x (scm_list_1 (subr));
1862 return *SCM_SUBR_GENERIC (subr);
1863 }
1864 SCM_WRONG_TYPE_ARG (SCM_ARG1, subr);
1865 }
1866 #undef FUNC_NAME
1867
1868 typedef struct t_extension {
1869 struct t_extension *next;
1870 SCM extended;
1871 SCM extension;
1872 } t_extension;
1873
1874 static t_extension *extensions = 0;
1875
1876 SCM_VARIABLE (scm_var_make_extended_generic, "make-extended-generic");
1877
1878 void
1879 scm_c_extend_primitive_generic (SCM extended, SCM extension)
1880 {
1881 if (goops_loaded_p)
1882 {
1883 SCM gf, gext;
1884 if (!*SCM_SUBR_GENERIC (extended))
1885 scm_enable_primitive_generic_x (scm_list_1 (extended));
1886 gf = *SCM_SUBR_GENERIC (extended);
1887 gext = scm_call_2 (SCM_VARIABLE_REF (scm_var_make_extended_generic),
1888 gf,
1889 SCM_SNAME (extension));
1890 *SCM_SUBR_GENERIC (extension) = gext;
1891 }
1892 else
1893 {
1894 t_extension *e = scm_malloc (sizeof (t_extension));
1895 t_extension **loc = &extensions;
1896 /* Make sure that extensions are placed before their own
1897 * extensions in the extensions list. O(N^2) algorithm, but
1898 * extensions of primitive generics are rare.
1899 */
1900 while (*loc && extension != (*loc)->extended)
1901 loc = &(*loc)->next;
1902 e->next = *loc;
1903 e->extended = extended;
1904 e->extension = extension;
1905 *loc = e;
1906 }
1907 }
1908
1909 static void
1910 setup_extended_primitive_generics ()
1911 {
1912 while (extensions)
1913 {
1914 t_extension *e = extensions;
1915 scm_c_extend_primitive_generic (e->extended, e->extension);
1916 extensions = e->next;
1917 free (e);
1918 }
1919 }
1920
1921 /******************************************************************************
1922 *
1923 * Protocol for calling a generic fumction
1924 * This protocol is roughly equivalent to (parameter are a little bit different
1925 * for efficiency reasons):
1926 *
1927 * + apply-generic (gf args)
1928 * + compute-applicable-methods (gf args ...)
1929 * + sort-applicable-methods (methods args)
1930 * + apply-methods (gf methods args)
1931 *
1932 * apply-methods calls make-next-method to build the "continuation" of a a
1933 * method. Applying a next-method will call apply-next-method which in
1934 * turn will call apply again to call effectively the following method.
1935 *
1936 ******************************************************************************/
1937
1938 static int
1939 applicablep (SCM actual, SCM formal)
1940 {
1941 /* We already know that the cpl is well formed. */
1942 return scm_is_true (scm_c_memq (formal, SCM_SLOT (actual, scm_si_cpl)));
1943 }
1944
1945 static int
1946 more_specificp (SCM m1, SCM m2, SCM const *targs)
1947 {
1948 register SCM s1, s2;
1949 register long i;
1950 /*
1951 * Note:
1952 * m1 and m2 can have != length (i.e. one can be one element longer than the
1953 * other when we have a dotted parameter list). For instance, with the call
1954 * (M 1)
1955 * with
1956 * (define-method M (a . l) ....)
1957 * (define-method M (a) ....)
1958 *
1959 * we consider that the second method is more specific.
1960 *
1961 * BTW, targs is an array of types. We don't need it's size since
1962 * we already know that m1 and m2 are applicable (no risk to go past
1963 * the end of this array).
1964 *
1965 */
1966 for (i=0, s1=SPEC_OF(m1), s2=SPEC_OF(m2); ; i++, s1=SCM_CDR(s1), s2=SCM_CDR(s2)) {
1967 if (scm_is_null(s1)) return 1;
1968 if (scm_is_null(s2)) return 0;
1969 if (SCM_CAR(s1) != SCM_CAR(s2)) {
1970 register SCM l, cs1 = SCM_CAR(s1), cs2 = SCM_CAR(s2);
1971
1972 for (l = SCM_SLOT (targs[i], scm_si_cpl); ; l = SCM_CDR(l)) {
1973 if (cs1 == SCM_CAR(l))
1974 return 1;
1975 if (cs2 == SCM_CAR(l))
1976 return 0;
1977 }
1978 return 0;/* should not occur! */
1979 }
1980 }
1981 return 0; /* should not occur! */
1982 }
1983
1984 #define BUFFSIZE 32 /* big enough for most uses */
1985
1986 static SCM
1987 scm_i_vector2list (SCM l, long len)
1988 {
1989 long j;
1990 SCM z = scm_c_make_vector (len, SCM_UNDEFINED);
1991
1992 for (j = 0; j < len; j++, l = SCM_CDR (l)) {
1993 SCM_SIMPLE_VECTOR_SET (z, j, SCM_CAR (l));
1994 }
1995 return z;
1996 }
1997
1998 static SCM
1999 sort_applicable_methods (SCM method_list, long size, SCM const *targs)
2000 {
2001 long i, j, incr;
2002 SCM *v, vector = SCM_EOL;
2003 SCM buffer[BUFFSIZE];
2004 SCM save = method_list;
2005 scm_t_array_handle handle;
2006
2007 /* For reasonably sized method_lists we can try to avoid all the
2008 * consing and reorder the list in place...
2009 * This idea is due to David McClain <Dave_McClain@msn.com>
2010 */
2011 if (size <= BUFFSIZE)
2012 {
2013 for (i = 0; i < size; i++)
2014 {
2015 buffer[i] = SCM_CAR (method_list);
2016 method_list = SCM_CDR (method_list);
2017 }
2018 v = buffer;
2019 }
2020 else
2021 {
2022 /* Too many elements in method_list to keep everything locally */
2023 vector = scm_i_vector2list (save, size);
2024 v = scm_vector_writable_elements (vector, &handle, NULL, NULL);
2025 }
2026
2027 /* Use a simple shell sort since it is generally faster than qsort on
2028 * small vectors (which is probably mostly the case when we have to
2029 * sort a list of applicable methods).
2030 */
2031 for (incr = size / 2; incr; incr /= 2)
2032 {
2033 for (i = incr; i < size; i++)
2034 {
2035 for (j = i - incr; j >= 0; j -= incr)
2036 {
2037 if (more_specificp (v[j], v[j+incr], targs))
2038 break;
2039 else
2040 {
2041 SCM tmp = v[j + incr];
2042 v[j + incr] = v[j];
2043 v[j] = tmp;
2044 }
2045 }
2046 }
2047 }
2048
2049 if (size <= BUFFSIZE)
2050 {
2051 /* We did it in locally, so restore the original list (reordered) in-place */
2052 for (i = 0, method_list = save; i < size; i++, v++)
2053 {
2054 SCM_SETCAR (method_list, *v);
2055 method_list = SCM_CDR (method_list);
2056 }
2057 return save;
2058 }
2059
2060 /* If we are here, that's that we did it the hard way... */
2061 scm_array_handle_release (&handle);
2062 return scm_vector_to_list (vector);
2063 }
2064
2065 SCM
2066 scm_compute_applicable_methods (SCM gf, SCM args, long len, int find_method_p)
2067 {
2068 register long i;
2069 long count = 0;
2070 SCM l, fl, applicable = SCM_EOL;
2071 SCM save = args;
2072 SCM buffer[BUFFSIZE];
2073 SCM const *types;
2074 SCM *p;
2075 SCM tmp = SCM_EOL;
2076 scm_t_array_handle handle;
2077
2078 /* Build the list of arguments types */
2079 if (len >= BUFFSIZE)
2080 {
2081 tmp = scm_c_make_vector (len, SCM_UNDEFINED);
2082 types = p = scm_vector_writable_elements (tmp, &handle, NULL, NULL);
2083
2084 /*
2085 note that we don't have to work to reset the generation
2086 count. TMP is a new vector anyway, and it is found
2087 conservatively.
2088 */
2089 }
2090 else
2091 types = p = buffer;
2092
2093 for ( ; !scm_is_null (args); args = SCM_CDR (args))
2094 *p++ = scm_class_of (SCM_CAR (args));
2095
2096 /* Build a list of all applicable methods */
2097 for (l = scm_generic_function_methods (gf); !scm_is_null (l); l = SCM_CDR (l))
2098 {
2099 fl = SPEC_OF (SCM_CAR (l));
2100 /* Only accept accessors which match exactly in first arg. */
2101 if (SCM_ACCESSORP (SCM_CAR (l))
2102 && (scm_is_null (fl) || types[0] != SCM_CAR (fl)))
2103 continue;
2104 for (i = 0; ; i++, fl = SCM_CDR (fl))
2105 {
2106 if (SCM_INSTANCEP (fl)
2107 /* We have a dotted argument list */
2108 || (i >= len && scm_is_null (fl)))
2109 { /* both list exhausted */
2110 applicable = scm_cons (SCM_CAR (l), applicable);
2111 count += 1;
2112 break;
2113 }
2114 if (i >= len
2115 || scm_is_null (fl)
2116 || !applicablep (types[i], SCM_CAR (fl)))
2117 break;
2118 }
2119 }
2120
2121 if (len >= BUFFSIZE)
2122 scm_array_handle_release (&handle);
2123
2124 if (count == 0)
2125 {
2126 if (find_method_p)
2127 return SCM_BOOL_F;
2128 CALL_GF2 ("no-applicable-method", gf, save);
2129 /* if we are here, it's because no-applicable-method hasn't signaled an error */
2130 return SCM_BOOL_F;
2131 }
2132
2133 return (count == 1
2134 ? applicable
2135 : sort_applicable_methods (applicable, count, types));
2136 }
2137
2138 #if 0
2139 SCM_PROC (s_sys_compute_applicable_methods, "%compute-applicable-methods", 2, 0, 0, scm_sys_compute_applicable_methods);
2140 #endif
2141
2142 static const char s_sys_compute_applicable_methods[] = "%compute-applicable-methods";
2143
2144 SCM
2145 scm_sys_compute_applicable_methods (SCM gf, SCM args)
2146 #define FUNC_NAME s_sys_compute_applicable_methods
2147 {
2148 long n;
2149 SCM_VALIDATE_GENERIC (1, gf);
2150 n = scm_ilength (args);
2151 SCM_ASSERT (n >= 0, args, SCM_ARG2, FUNC_NAME);
2152 return scm_compute_applicable_methods (gf, args, n, 1);
2153 }
2154 #undef FUNC_NAME
2155
2156 SCM_SYMBOL (sym_compute_applicable_methods, "compute-applicable-methods");
2157 SCM_VARIABLE_INIT (var_compute_applicable_methods, "compute-applicable-methods", scm_c_define_gsubr (s_sys_compute_applicable_methods, 2, 0, 0, scm_sys_compute_applicable_methods));
2158
2159 static void
2160 lock_cache_mutex (void *m)
2161 {
2162 SCM mutex = SCM_PACK ((scm_t_bits) m);
2163 scm_lock_mutex (mutex);
2164 }
2165
2166 static void
2167 unlock_cache_mutex (void *m)
2168 {
2169 SCM mutex = SCM_PACK ((scm_t_bits) m);
2170 scm_unlock_mutex (mutex);
2171 }
2172
2173 static SCM
2174 call_memoize_method (void *a)
2175 {
2176 SCM args = SCM_PACK ((scm_t_bits) a);
2177 SCM gf = SCM_CAR (args);
2178 SCM x = SCM_CADR (args);
2179 /* First check if another thread has inserted a method between
2180 * the cache miss and locking the mutex.
2181 */
2182 SCM cmethod = scm_mcache_lookup_cmethod (x, SCM_CDDR (args));
2183 if (scm_is_true (cmethod))
2184 return cmethod;
2185 /*fixme* Use scm_apply */
2186 return CALL_GF3 ("memoize-method!", gf, SCM_CDDR (args), x);
2187 }
2188
2189 SCM
2190 scm_memoize_method (SCM x, SCM args)
2191 {
2192 SCM gf = SCM_CAR (scm_last_pair (x));
2193 return scm_internal_dynamic_wind (
2194 lock_cache_mutex,
2195 call_memoize_method,
2196 unlock_cache_mutex,
2197 (void *) SCM_UNPACK (scm_cons2 (gf, x, args)),
2198 (void *) SCM_UNPACK (SCM_SLOT (gf, scm_si_cache_mutex)));
2199 }
2200
2201 /******************************************************************************
2202 *
2203 * A simple make (which will be redefined later in Scheme)
2204 * This version handles only creation of gf, methods and classes (no instances)
2205 *
2206 * Since this code will disappear when Goops will be fully booted,
2207 * no precaution is taken to be efficient.
2208 *
2209 ******************************************************************************/
2210
2211 SCM_KEYWORD (k_setter, "setter");
2212 SCM_KEYWORD (k_specializers, "specializers");
2213 SCM_KEYWORD (k_procedure, "procedure");
2214 SCM_KEYWORD (k_dsupers, "dsupers");
2215 SCM_KEYWORD (k_slots, "slots");
2216 SCM_KEYWORD (k_gf, "generic-function");
2217
2218 SCM_DEFINE (scm_make, "make", 0, 0, 1,
2219 (SCM args),
2220 "Make a new object. @var{args} must contain the class and\n"
2221 "all necessary initialization information.")
2222 #define FUNC_NAME s_scm_make
2223 {
2224 SCM class, z;
2225 long len = scm_ilength (args);
2226
2227 if (len <= 0 || (len & 1) == 0)
2228 SCM_WRONG_NUM_ARGS ();
2229
2230 class = SCM_CAR(args);
2231 args = SCM_CDR(args);
2232
2233 if (class == scm_class_generic || class == scm_class_accessor)
2234 {
2235 z = scm_make_struct (class, SCM_INUM0,
2236 scm_list_5 (SCM_EOL,
2237 SCM_INUM0,
2238 SCM_BOOL_F,
2239 scm_make_mutex (),
2240 SCM_EOL));
2241 scm_set_procedure_property_x (z, scm_sym_name,
2242 scm_get_keyword (k_name,
2243 args,
2244 SCM_BOOL_F));
2245 clear_method_cache (z);
2246 if (class == scm_class_accessor)
2247 {
2248 SCM setter = scm_get_keyword (k_setter, args, SCM_BOOL_F);
2249 if (scm_is_true (setter))
2250 scm_sys_set_object_setter_x (z, setter);
2251 }
2252 }
2253 else
2254 {
2255 z = scm_sys_allocate_instance (class, args);
2256
2257 if (class == scm_class_method
2258 || class == scm_class_simple_method
2259 || class == scm_class_accessor_method)
2260 {
2261 SCM_SET_SLOT (z, scm_si_generic_function,
2262 scm_i_get_keyword (k_gf,
2263 args,
2264 len - 1,
2265 SCM_BOOL_F,
2266 FUNC_NAME));
2267 SCM_SET_SLOT (z, scm_si_specializers,
2268 scm_i_get_keyword (k_specializers,
2269 args,
2270 len - 1,
2271 SCM_EOL,
2272 FUNC_NAME));
2273 SCM_SET_SLOT (z, scm_si_procedure,
2274 scm_i_get_keyword (k_procedure,
2275 args,
2276 len - 1,
2277 SCM_EOL,
2278 FUNC_NAME));
2279 SCM_SET_SLOT (z, scm_si_code_table, SCM_EOL);
2280 }
2281 else
2282 {
2283 /* In all the others case, make a new class .... No instance here */
2284 SCM_SET_SLOT (z, scm_si_name,
2285 scm_i_get_keyword (k_name,
2286 args,
2287 len - 1,
2288 scm_from_locale_symbol ("???"),
2289 FUNC_NAME));
2290 SCM_SET_SLOT (z, scm_si_direct_supers,
2291 scm_i_get_keyword (k_dsupers,
2292 args,
2293 len - 1,
2294 SCM_EOL,
2295 FUNC_NAME));
2296 SCM_SET_SLOT (z, scm_si_direct_slots,
2297 scm_i_get_keyword (k_slots,
2298 args,
2299 len - 1,
2300 SCM_EOL,
2301 FUNC_NAME));
2302 }
2303 }
2304 return z;
2305 }
2306 #undef FUNC_NAME
2307
2308 SCM_DEFINE (scm_find_method, "find-method", 0, 0, 1,
2309 (SCM l),
2310 "")
2311 #define FUNC_NAME s_scm_find_method
2312 {
2313 SCM gf;
2314 long len = scm_ilength (l);
2315
2316 if (len == 0)
2317 SCM_WRONG_NUM_ARGS ();
2318
2319 gf = SCM_CAR(l); l = SCM_CDR(l);
2320 SCM_VALIDATE_GENERIC (1, gf);
2321 if (scm_is_null (SCM_SLOT (gf, scm_si_methods)))
2322 SCM_MISC_ERROR ("no methods for generic ~S", scm_list_1 (gf));
2323
2324 return scm_compute_applicable_methods (gf, l, len - 1, 1);
2325 }
2326 #undef FUNC_NAME
2327
2328 SCM_DEFINE (scm_sys_method_more_specific_p, "%method-more-specific?", 3, 0, 0,
2329 (SCM m1, SCM m2, SCM targs),
2330 "Return true if method @var{m1} is more specific than @var{m2} "
2331 "given the argument types (classes) listed in @var{targs}.")
2332 #define FUNC_NAME s_scm_sys_method_more_specific_p
2333 {
2334 SCM l, v, result;
2335 SCM *v_elts;
2336 long i, len, m1_specs, m2_specs;
2337 scm_t_array_handle handle;
2338
2339 SCM_VALIDATE_METHOD (1, m1);
2340 SCM_VALIDATE_METHOD (2, m2);
2341
2342 len = scm_ilength (targs);
2343 m1_specs = scm_ilength (SPEC_OF (m1));
2344 m2_specs = scm_ilength (SPEC_OF (m2));
2345 SCM_ASSERT ((len >= m1_specs) || (len >= m2_specs),
2346 targs, SCM_ARG3, FUNC_NAME);
2347
2348 /* Verify that all the arguments of TARGS are classes and place them
2349 in a vector. */
2350
2351 v = scm_c_make_vector (len, SCM_EOL);
2352 v_elts = scm_vector_writable_elements (v, &handle, NULL, NULL);
2353
2354 for (i = 0, l = targs;
2355 i < len && scm_is_pair (l);
2356 i++, l = SCM_CDR (l))
2357 {
2358 SCM_ASSERT (SCM_CLASSP (SCM_CAR (l)), targs, SCM_ARG3, FUNC_NAME);
2359 v_elts[i] = SCM_CAR (l);
2360 }
2361 result = more_specificp (m1, m2, v_elts) ? SCM_BOOL_T: SCM_BOOL_F;
2362
2363 scm_array_handle_release (&handle);
2364
2365 return result;
2366 }
2367 #undef FUNC_NAME
2368
2369
2370
2371 /******************************************************************************
2372 *
2373 * Initializations
2374 *
2375 ******************************************************************************/
2376
2377 static void
2378 fix_cpl (SCM c, SCM before, SCM after)
2379 {
2380 SCM cpl = SCM_SLOT (c, scm_si_cpl);
2381 SCM ls = scm_c_memq (after, cpl);
2382 SCM tail = scm_delq1_x (before, SCM_CDR (ls));
2383 if (scm_is_false (ls))
2384 /* if this condition occurs, fix_cpl should not be applied this way */
2385 abort ();
2386 SCM_SETCAR (ls, before);
2387 SCM_SETCDR (ls, scm_cons (after, tail));
2388 {
2389 SCM dslots = SCM_SLOT (c, scm_si_direct_slots);
2390 SCM slots = build_slots_list (maplist (dslots), cpl);
2391 SCM g_n_s = compute_getters_n_setters (slots);
2392 SCM_SET_SLOT (c, scm_si_slots, slots);
2393 SCM_SET_SLOT (c, scm_si_getters_n_setters, g_n_s);
2394 }
2395 }
2396
2397
2398 static void
2399 make_stdcls (SCM *var, char *name, SCM meta, SCM super, SCM slots)
2400 {
2401 SCM tmp = scm_from_locale_symbol (name);
2402
2403 *var = scm_permanent_object (scm_basic_make_class (meta,
2404 tmp,
2405 scm_is_pair (super)
2406 ? super
2407 : scm_list_1 (super),
2408 slots));
2409 DEFVAR(tmp, *var);
2410 }
2411
2412
2413 SCM_KEYWORD (k_slot_definition, "slot-definition");
2414
2415 static void
2416 create_standard_classes (void)
2417 {
2418 SCM slots;
2419 SCM method_slots = scm_list_4 (scm_from_locale_symbol ("generic-function"),
2420 scm_from_locale_symbol ("specializers"),
2421 sym_procedure,
2422 scm_from_locale_symbol ("code-table"));
2423 SCM amethod_slots = scm_list_1 (scm_list_3 (scm_from_locale_symbol ("slot-definition"),
2424 k_init_keyword,
2425 k_slot_definition));
2426 SCM mutex_slot = scm_list_1 (scm_from_locale_symbol ("make-mutex"));
2427 SCM mutex_closure = scm_i_eval_x (scm_list_3 (scm_sym_lambda,
2428 SCM_EOL,
2429 mutex_slot),
2430 SCM_EOL);
2431 SCM gf_slots = scm_list_5 (scm_from_locale_symbol ("methods"),
2432 scm_list_3 (scm_from_locale_symbol ("n-specialized"),
2433 k_init_value,
2434 SCM_INUM0),
2435 scm_list_3 (scm_from_locale_symbol ("used-by"),
2436 k_init_value,
2437 SCM_BOOL_F),
2438 scm_list_3 (scm_from_locale_symbol ("cache-mutex"),
2439 k_init_thunk,
2440 mutex_closure),
2441 scm_list_3 (scm_from_locale_symbol ("extended-by"),
2442 k_init_value,
2443 SCM_EOL));
2444 SCM egf_slots = scm_list_1 (scm_list_3 (scm_from_locale_symbol ("extends"),
2445 k_init_value,
2446 SCM_EOL));
2447 /* Foreign class slot classes */
2448 make_stdcls (&scm_class_foreign_slot, "<foreign-slot>",
2449 scm_class_class, scm_class_top, SCM_EOL);
2450 make_stdcls (&scm_class_protected, "<protected-slot>",
2451 scm_class_class, scm_class_foreign_slot, SCM_EOL);
2452 make_stdcls (&scm_class_opaque, "<opaque-slot>",
2453 scm_class_class, scm_class_foreign_slot, SCM_EOL);
2454 make_stdcls (&scm_class_read_only, "<read-only-slot>",
2455 scm_class_class, scm_class_foreign_slot, SCM_EOL);
2456 make_stdcls (&scm_class_self, "<self-slot>",
2457 scm_class_class,
2458 scm_class_read_only,
2459 SCM_EOL);
2460 make_stdcls (&scm_class_protected_opaque, "<protected-opaque-slot>",
2461 scm_class_class,
2462 scm_list_2 (scm_class_protected, scm_class_opaque),
2463 SCM_EOL);
2464 make_stdcls (&scm_class_protected_read_only, "<protected-read-only-slot>",
2465 scm_class_class,
2466 scm_list_2 (scm_class_protected, scm_class_read_only),
2467 SCM_EOL);
2468 make_stdcls (&scm_class_scm, "<scm-slot>",
2469 scm_class_class, scm_class_protected, SCM_EOL);
2470 make_stdcls (&scm_class_int, "<int-slot>",
2471 scm_class_class, scm_class_foreign_slot, SCM_EOL);
2472 make_stdcls (&scm_class_float, "<float-slot>",
2473 scm_class_class, scm_class_foreign_slot, SCM_EOL);
2474 make_stdcls (&scm_class_double, "<double-slot>",
2475 scm_class_class, scm_class_foreign_slot, SCM_EOL);
2476
2477 /* Continue initialization of class <class> */
2478
2479 slots = build_class_class_slots ();
2480 SCM_SET_SLOT (scm_class_class, scm_si_direct_slots, slots);
2481 SCM_SET_SLOT (scm_class_class, scm_si_slots, slots);
2482 SCM_SET_SLOT (scm_class_class, scm_si_getters_n_setters,
2483 compute_getters_n_setters (slots));
2484
2485 make_stdcls (&scm_class_foreign_class, "<foreign-class>",
2486 scm_class_class, scm_class_class,
2487 scm_list_2 (scm_list_3 (scm_from_locale_symbol ("constructor"),
2488 k_class,
2489 scm_class_opaque),
2490 scm_list_3 (scm_from_locale_symbol ("destructor"),
2491 k_class,
2492 scm_class_opaque)));
2493 make_stdcls (&scm_class_foreign_object, "<foreign-object>",
2494 scm_class_foreign_class, scm_class_object, SCM_EOL);
2495 SCM_SET_CLASS_FLAGS (scm_class_foreign_object, SCM_CLASSF_FOREIGN);
2496
2497 /* scm_class_generic functions classes */
2498 make_stdcls (&scm_class_procedure_class, "<procedure-class>",
2499 scm_class_class, scm_class_class, SCM_EOL);
2500 make_stdcls (&scm_class_entity_class, "<entity-class>",
2501 scm_class_class, scm_class_procedure_class, SCM_EOL);
2502 make_stdcls (&scm_class_operator_class, "<operator-class>",
2503 scm_class_class, scm_class_procedure_class, SCM_EOL);
2504 make_stdcls (&scm_class_operator_with_setter_class,
2505 "<operator-with-setter-class>",
2506 scm_class_class, scm_class_operator_class, SCM_EOL);
2507 make_stdcls (&scm_class_method, "<method>",
2508 scm_class_class, scm_class_object, method_slots);
2509 make_stdcls (&scm_class_simple_method, "<simple-method>",
2510 scm_class_class, scm_class_method, SCM_EOL);
2511 SCM_SET_CLASS_FLAGS (scm_class_simple_method, SCM_CLASSF_SIMPLE_METHOD);
2512 make_stdcls (&scm_class_accessor_method, "<accessor-method>",
2513 scm_class_class, scm_class_simple_method, amethod_slots);
2514 SCM_SET_CLASS_FLAGS (scm_class_accessor_method, SCM_CLASSF_ACCESSOR_METHOD);
2515 make_stdcls (&scm_class_applicable, "<applicable>",
2516 scm_class_class, scm_class_top, SCM_EOL);
2517 make_stdcls (&scm_class_entity, "<entity>",
2518 scm_class_entity_class,
2519 scm_list_2 (scm_class_object, scm_class_applicable),
2520 SCM_EOL);
2521 make_stdcls (&scm_class_entity_with_setter, "<entity-with-setter>",
2522 scm_class_entity_class, scm_class_entity, SCM_EOL);
2523 make_stdcls (&scm_class_generic, "<generic>",
2524 scm_class_entity_class, scm_class_entity, gf_slots);
2525 SCM_SET_CLASS_FLAGS (scm_class_generic, SCM_CLASSF_PURE_GENERIC);
2526 make_stdcls (&scm_class_extended_generic, "<extended-generic>",
2527 scm_class_entity_class, scm_class_generic, egf_slots);
2528 SCM_SET_CLASS_FLAGS (scm_class_extended_generic, SCM_CLASSF_PURE_GENERIC);
2529 make_stdcls (&scm_class_generic_with_setter, "<generic-with-setter>",
2530 scm_class_entity_class,
2531 scm_list_2 (scm_class_generic, scm_class_entity_with_setter),
2532 SCM_EOL);
2533 SCM_SET_CLASS_FLAGS (scm_class_generic_with_setter, SCM_CLASSF_PURE_GENERIC);
2534 make_stdcls (&scm_class_accessor, "<accessor>",
2535 scm_class_entity_class, scm_class_generic_with_setter, SCM_EOL);
2536 SCM_SET_CLASS_FLAGS (scm_class_accessor, SCM_CLASSF_PURE_GENERIC);
2537 make_stdcls (&scm_class_extended_generic_with_setter,
2538 "<extended-generic-with-setter>",
2539 scm_class_entity_class,
2540 scm_list_2 (scm_class_generic_with_setter,
2541 scm_class_extended_generic),
2542 SCM_EOL);
2543 SCM_SET_CLASS_FLAGS (scm_class_extended_generic_with_setter,
2544 SCM_CLASSF_PURE_GENERIC);
2545 make_stdcls (&scm_class_extended_accessor, "<extended-accessor>",
2546 scm_class_entity_class,
2547 scm_list_2 (scm_class_accessor,
2548 scm_class_extended_generic_with_setter),
2549 SCM_EOL);
2550 fix_cpl (scm_class_extended_accessor,
2551 scm_class_extended_generic, scm_class_generic);
2552 SCM_SET_CLASS_FLAGS (scm_class_extended_accessor, SCM_CLASSF_PURE_GENERIC);
2553
2554 /* Primitive types classes */
2555 make_stdcls (&scm_class_boolean, "<boolean>",
2556 scm_class_class, scm_class_top, SCM_EOL);
2557 make_stdcls (&scm_class_char, "<char>",
2558 scm_class_class, scm_class_top, SCM_EOL);
2559 make_stdcls (&scm_class_list, "<list>",
2560 scm_class_class, scm_class_top, SCM_EOL);
2561 make_stdcls (&scm_class_pair, "<pair>",
2562 scm_class_class, scm_class_list, SCM_EOL);
2563 make_stdcls (&scm_class_null, "<null>",
2564 scm_class_class, scm_class_list, SCM_EOL);
2565 make_stdcls (&scm_class_string, "<string>",
2566 scm_class_class, scm_class_top, SCM_EOL);
2567 make_stdcls (&scm_class_symbol, "<symbol>",
2568 scm_class_class, scm_class_top, SCM_EOL);
2569 make_stdcls (&scm_class_vector, "<vector>",
2570 scm_class_class, scm_class_top, SCM_EOL);
2571 make_stdcls (&scm_class_number, "<number>",
2572 scm_class_class, scm_class_top, SCM_EOL);
2573 make_stdcls (&scm_class_complex, "<complex>",
2574 scm_class_class, scm_class_number, SCM_EOL);
2575 make_stdcls (&scm_class_real, "<real>",
2576 scm_class_class, scm_class_complex, SCM_EOL);
2577 make_stdcls (&scm_class_integer, "<integer>",
2578 scm_class_class, scm_class_real, SCM_EOL);
2579 make_stdcls (&scm_class_fraction, "<fraction>",
2580 scm_class_class, scm_class_real, SCM_EOL);
2581 make_stdcls (&scm_class_keyword, "<keyword>",
2582 scm_class_class, scm_class_top, SCM_EOL);
2583 make_stdcls (&scm_class_unknown, "<unknown>",
2584 scm_class_class, scm_class_top, SCM_EOL);
2585 make_stdcls (&scm_class_procedure, "<procedure>",
2586 scm_class_procedure_class, scm_class_applicable, SCM_EOL);
2587 make_stdcls (&scm_class_procedure_with_setter, "<procedure-with-setter>",
2588 scm_class_procedure_class, scm_class_procedure, SCM_EOL);
2589 make_stdcls (&scm_class_primitive_generic, "<primitive-generic>",
2590 scm_class_procedure_class, scm_class_procedure, SCM_EOL);
2591 make_stdcls (&scm_class_port, "<port>",
2592 scm_class_class, scm_class_top, SCM_EOL);
2593 make_stdcls (&scm_class_input_port, "<input-port>",
2594 scm_class_class, scm_class_port, SCM_EOL);
2595 make_stdcls (&scm_class_output_port, "<output-port>",
2596 scm_class_class, scm_class_port, SCM_EOL);
2597 make_stdcls (&scm_class_input_output_port, "<input-output-port>",
2598 scm_class_class,
2599 scm_list_2 (scm_class_input_port, scm_class_output_port),
2600 SCM_EOL);
2601 }
2602
2603 /**********************************************************************
2604 *
2605 * Smob classes
2606 *
2607 **********************************************************************/
2608
2609 static SCM
2610 make_class_from_template (char const *template, char const *type_name, SCM supers, int applicablep)
2611 {
2612 SCM class, name;
2613 if (type_name)
2614 {
2615 char buffer[100];
2616 sprintf (buffer, template, type_name);
2617 name = scm_from_locale_symbol (buffer);
2618 }
2619 else
2620 name = SCM_GOOPS_UNBOUND;
2621
2622 class = scm_permanent_object (scm_basic_make_class (applicablep
2623 ? scm_class_procedure_class
2624 : scm_class_class,
2625 name,
2626 supers,
2627 SCM_EOL));
2628
2629 /* Only define name if doesn't already exist. */
2630 if (!SCM_GOOPS_UNBOUNDP (name)
2631 && scm_is_false (scm_call_2 (scm_goops_lookup_closure, name, SCM_BOOL_F)))
2632 DEFVAR (name, class);
2633 return class;
2634 }
2635
2636 SCM
2637 scm_make_extended_class (char const *type_name, int applicablep)
2638 {
2639 return make_class_from_template ("<%s>",
2640 type_name,
2641 scm_list_1 (applicablep
2642 ? scm_class_applicable
2643 : scm_class_top),
2644 applicablep);
2645 }
2646
2647 void
2648 scm_i_inherit_applicable (SCM c)
2649 {
2650 if (!SCM_SUBCLASSP (c, scm_class_applicable))
2651 {
2652 SCM dsupers = SCM_SLOT (c, scm_si_direct_supers);
2653 SCM cpl = SCM_SLOT (c, scm_si_cpl);
2654 /* patch scm_class_applicable into direct-supers */
2655 SCM top = scm_c_memq (scm_class_top, dsupers);
2656 if (scm_is_false (top))
2657 dsupers = scm_append (scm_list_2 (dsupers,
2658 scm_list_1 (scm_class_applicable)));
2659 else
2660 {
2661 SCM_SETCAR (top, scm_class_applicable);
2662 SCM_SETCDR (top, scm_cons (scm_class_top, SCM_CDR (top)));
2663 }
2664 SCM_SET_SLOT (c, scm_si_direct_supers, dsupers);
2665 /* patch scm_class_applicable into cpl */
2666 top = scm_c_memq (scm_class_top, cpl);
2667 if (scm_is_false (top))
2668 abort ();
2669 else
2670 {
2671 SCM_SETCAR (top, scm_class_applicable);
2672 SCM_SETCDR (top, scm_cons (scm_class_top, SCM_CDR (top)));
2673 }
2674 /* add class to direct-subclasses of scm_class_applicable */
2675 SCM_SET_SLOT (scm_class_applicable,
2676 scm_si_direct_subclasses,
2677 scm_cons (c, SCM_SLOT (scm_class_applicable,
2678 scm_si_direct_subclasses)));
2679 }
2680 }
2681
2682 static void
2683 create_smob_classes (void)
2684 {
2685 long i;
2686
2687 scm_smob_class = (SCM *) scm_malloc (255 * sizeof (SCM));
2688 for (i = 0; i < 255; ++i)
2689 scm_smob_class[i] = 0;
2690
2691 scm_smob_class[SCM_TC2SMOBNUM (scm_tc16_keyword)] = scm_class_keyword;
2692
2693 for (i = 0; i < scm_numsmob; ++i)
2694 if (!scm_smob_class[i])
2695 scm_smob_class[i] = scm_make_extended_class (SCM_SMOBNAME (i),
2696 scm_smobs[i].apply != 0);
2697 }
2698
2699 void
2700 scm_make_port_classes (long ptobnum, char *type_name)
2701 {
2702 SCM c, class = make_class_from_template ("<%s-port>",
2703 type_name,
2704 scm_list_1 (scm_class_port),
2705 0);
2706 scm_port_class[SCM_IN_PCLASS_INDEX + ptobnum]
2707 = make_class_from_template ("<%s-input-port>",
2708 type_name,
2709 scm_list_2 (class, scm_class_input_port),
2710 0);
2711 scm_port_class[SCM_OUT_PCLASS_INDEX + ptobnum]
2712 = make_class_from_template ("<%s-output-port>",
2713 type_name,
2714 scm_list_2 (class, scm_class_output_port),
2715 0);
2716 scm_port_class[SCM_INOUT_PCLASS_INDEX + ptobnum]
2717 = c
2718 = make_class_from_template ("<%s-input-output-port>",
2719 type_name,
2720 scm_list_2 (class, scm_class_input_output_port),
2721 0);
2722 /* Patch cpl (since this tree is too complex for the C level compute-cpl) */
2723 SCM_SET_SLOT (c, scm_si_cpl,
2724 scm_cons2 (c, class, SCM_SLOT (scm_class_input_output_port, scm_si_cpl)));
2725 }
2726
2727 static void
2728 create_port_classes (void)
2729 {
2730 long i;
2731
2732 scm_port_class = (SCM *) scm_malloc (3 * 256 * sizeof (SCM));
2733 for (i = 0; i < 3 * 256; ++i)
2734 scm_port_class[i] = 0;
2735
2736 for (i = 0; i < scm_numptob; ++i)
2737 scm_make_port_classes (i, SCM_PTOBNAME (i));
2738 }
2739
2740 static SCM
2741 make_struct_class (void *closure SCM_UNUSED,
2742 SCM vtable, SCM data, SCM prev SCM_UNUSED)
2743 {
2744 if (scm_is_true (SCM_STRUCT_TABLE_NAME (data)))
2745 SCM_SET_STRUCT_TABLE_CLASS (data,
2746 scm_make_extended_class
2747 (scm_i_symbol_chars (SCM_STRUCT_TABLE_NAME (data)),
2748 SCM_CLASS_FLAGS (vtable) & SCM_CLASSF_OPERATOR));
2749 return SCM_UNSPECIFIED;
2750 }
2751
2752 static void
2753 create_struct_classes (void)
2754 {
2755 scm_internal_hash_fold (make_struct_class, 0, SCM_BOOL_F, scm_struct_table);
2756 }
2757
2758 /**********************************************************************
2759 *
2760 * C interface
2761 *
2762 **********************************************************************/
2763
2764 void
2765 scm_load_goops ()
2766 {
2767 if (!goops_loaded_p)
2768 scm_c_resolve_module ("oop goops");
2769 }
2770
2771
2772 SCM
2773 scm_make_foreign_object (SCM class, SCM initargs)
2774 #define FUNC_NAME s_scm_make
2775 {
2776 void * (*constructor) (SCM)
2777 = (void * (*) (SCM)) SCM_SLOT (class, scm_si_constructor);
2778 if (constructor == 0)
2779 SCM_MISC_ERROR ("Can't make instances of class ~S", scm_list_1 (class));
2780 return scm_wrap_object (class, constructor (initargs));
2781 }
2782 #undef FUNC_NAME
2783
2784
2785 static size_t
2786 scm_free_foreign_object (SCM *class, SCM *data)
2787 {
2788 size_t (*destructor) (void *)
2789 = (size_t (*) (void *)) class[scm_si_destructor];
2790 return destructor (data);
2791 }
2792
2793 SCM
2794 scm_make_class (SCM meta, char *s_name, SCM supers, size_t size,
2795 void * (*constructor) (SCM initargs),
2796 size_t (*destructor) (void *))
2797 {
2798 SCM name, class;
2799 name = scm_from_locale_symbol (s_name);
2800 if (scm_is_null (supers))
2801 supers = scm_list_1 (scm_class_foreign_object);
2802 class = scm_basic_basic_make_class (meta, name, supers, SCM_EOL);
2803 scm_sys_inherit_magic_x (class, supers);
2804
2805 if (destructor != 0)
2806 {
2807 SCM_SET_SLOT (class, scm_si_destructor, (SCM) destructor);
2808 SCM_SET_CLASS_DESTRUCTOR (class, scm_free_foreign_object);
2809 }
2810 else if (size > 0)
2811 {
2812 SCM_SET_CLASS_DESTRUCTOR (class, scm_struct_free_light);
2813 SCM_SET_CLASS_INSTANCE_SIZE (class, size);
2814 }
2815
2816 SCM_SET_SLOT (class, scm_si_layout, scm_from_locale_symbol (""));
2817 SCM_SET_SLOT (class, scm_si_constructor, (SCM) constructor);
2818
2819 return class;
2820 }
2821
2822 SCM_SYMBOL (sym_o, "o");
2823 SCM_SYMBOL (sym_x, "x");
2824
2825 SCM_KEYWORD (k_accessor, "accessor");
2826 SCM_KEYWORD (k_getter, "getter");
2827
2828 static SCM
2829 default_setter (SCM obj SCM_UNUSED, SCM c SCM_UNUSED)
2830 {
2831 scm_misc_error ("slot-set!", "read-only slot", SCM_EOL);
2832 return 0;
2833 }
2834
2835 void
2836 scm_add_slot (SCM class, char *slot_name, SCM slot_class,
2837 SCM (*getter) (SCM obj),
2838 SCM (*setter) (SCM obj, SCM x),
2839 char *accessor_name)
2840 {
2841 {
2842 SCM get = scm_c_make_subr ("goops:get", scm_tc7_subr_1, getter);
2843 SCM set = scm_c_make_subr ("goops:set", scm_tc7_subr_2,
2844 setter ? setter : default_setter);
2845
2846 /* Dirk:FIXME:: The following two expressions make use of the fact that
2847 * the memoizer will accept a subr-object in the place of a function.
2848 * This is not guaranteed to stay this way. */
2849 SCM getm = scm_i_eval_x (scm_list_3 (scm_sym_lambda,
2850 scm_list_1 (sym_o),
2851 scm_list_2 (get, sym_o)),
2852 SCM_EOL);
2853 SCM setm = scm_i_eval_x (scm_list_3 (scm_sym_lambda,
2854 scm_list_2 (sym_o, sym_x),
2855 scm_list_3 (set, sym_o, sym_x)),
2856 SCM_EOL);
2857
2858 {
2859 SCM name = scm_from_locale_symbol (slot_name);
2860 SCM aname = scm_from_locale_symbol (accessor_name);
2861 SCM gf = scm_ensure_accessor (aname);
2862 SCM slot = scm_list_5 (name,
2863 k_class,
2864 slot_class,
2865 setter ? k_accessor : k_getter,
2866 gf);
2867 scm_add_method (gf, scm_make (scm_list_5 (scm_class_accessor_method,
2868 k_specializers,
2869 scm_list_1 (class),
2870 k_procedure,
2871 getm)));
2872 scm_add_method (scm_setter (gf),
2873 scm_make (scm_list_5 (scm_class_accessor_method,
2874 k_specializers,
2875 scm_list_2 (class, scm_class_top),
2876 k_procedure,
2877 setm)));
2878 DEFVAR (aname, gf);
2879
2880 SCM_SET_SLOT (class, scm_si_slots,
2881 scm_append_x (scm_list_2 (SCM_SLOT (class, scm_si_slots),
2882 scm_list_1 (slot))));
2883 {
2884 SCM n = SCM_SLOT (class, scm_si_nfields);
2885 SCM gns = scm_list_n (name, SCM_BOOL_F, get, set, n, scm_from_int (1),
2886 SCM_UNDEFINED);
2887 SCM_SET_SLOT (class, scm_si_getters_n_setters,
2888 scm_append_x (scm_list_2 (SCM_SLOT (class, scm_si_getters_n_setters),
2889 scm_list_1 (gns))));
2890 SCM_SET_SLOT (class, scm_si_nfields, scm_sum (n, scm_from_int (1)));
2891 }
2892 }
2893 }
2894 }
2895
2896 SCM
2897 scm_wrap_object (SCM class, void *data)
2898 {
2899 return scm_double_cell (SCM_UNPACK (SCM_CDR (class)) | scm_tc3_struct,
2900 (scm_t_bits) data,
2901 0, 0);
2902 }
2903
2904 SCM scm_components;
2905
2906 SCM
2907 scm_wrap_component (SCM class, SCM container, void *data)
2908 {
2909 SCM obj = scm_wrap_object (class, data);
2910 SCM handle = scm_hash_fn_create_handle_x (scm_components,
2911 obj,
2912 SCM_BOOL_F,
2913 scm_struct_ihashq,
2914 scm_sloppy_assq,
2915 0);
2916 SCM_SETCDR (handle, container);
2917 return obj;
2918 }
2919
2920 SCM
2921 scm_ensure_accessor (SCM name)
2922 {
2923 SCM gf = scm_call_2 (SCM_TOP_LEVEL_LOOKUP_CLOSURE, name, SCM_BOOL_F);
2924 if (!SCM_IS_A_P (gf, scm_class_accessor))
2925 {
2926 gf = scm_make (scm_list_3 (scm_class_generic, k_name, name));
2927 gf = scm_make (scm_list_5 (scm_class_accessor,
2928 k_name, name, k_setter, gf));
2929 }
2930 return gf;
2931 }
2932
2933 SCM_SYMBOL (sym_internal_add_method_x, "internal-add-method!");
2934
2935 void
2936 scm_add_method (SCM gf, SCM m)
2937 {
2938 scm_eval (scm_list_3 (sym_internal_add_method_x, gf, m), scm_module_goops);
2939 }
2940
2941 #ifdef GUILE_DEBUG
2942 /*
2943 * Debugging utilities
2944 */
2945
2946 SCM_DEFINE (scm_pure_generic_p, "pure-generic?", 1, 0, 0,
2947 (SCM obj),
2948 "Return @code{#t} if @var{obj} is a pure generic.")
2949 #define FUNC_NAME s_scm_pure_generic_p
2950 {
2951 return scm_from_bool (SCM_PUREGENERICP (obj));
2952 }
2953 #undef FUNC_NAME
2954
2955 #endif /* GUILE_DEBUG */
2956
2957 /*
2958 * Initialization
2959 */
2960
2961 SCM_DEFINE (scm_sys_goops_loaded, "%goops-loaded", 0, 0, 0,
2962 (),
2963 "Announce that GOOPS is loaded and perform initialization\n"
2964 "on the C level which depends on the loaded GOOPS modules.")
2965 #define FUNC_NAME s_scm_sys_goops_loaded
2966 {
2967 goops_loaded_p = 1;
2968 var_compute_applicable_methods =
2969 scm_sym2var (sym_compute_applicable_methods, scm_goops_lookup_closure,
2970 SCM_BOOL_F);
2971 setup_extended_primitive_generics ();
2972 return SCM_UNSPECIFIED;
2973 }
2974 #undef FUNC_NAME
2975
2976 SCM scm_module_goops;
2977
2978 SCM
2979 scm_init_goops_builtins (void)
2980 {
2981 scm_module_goops = scm_current_module ();
2982 scm_goops_lookup_closure = scm_module_lookup_closure (scm_module_goops);
2983
2984 /* Not really necessary right now, but who knows...
2985 */
2986 scm_permanent_object (scm_module_goops);
2987 scm_permanent_object (scm_goops_lookup_closure);
2988
2989 scm_components = scm_permanent_object (scm_make_weak_key_hash_table
2990 (scm_from_int (37)));
2991
2992 goops_rstate = scm_c_make_rstate ("GOOPS", 5);
2993
2994 #include "libguile/goops.x"
2995
2996 list_of_no_method = scm_permanent_object (scm_list_1 (sym_no_method));
2997
2998 hell = scm_malloc (hell_size);
2999 hell_mutex = scm_permanent_object (scm_make_mutex ());
3000
3001 create_basic_classes ();
3002 create_standard_classes ();
3003 create_smob_classes ();
3004 create_struct_classes ();
3005 create_port_classes ();
3006
3007 {
3008 SCM name = scm_from_locale_symbol ("no-applicable-method");
3009 scm_no_applicable_method
3010 = scm_permanent_object (scm_make (scm_list_3 (scm_class_generic,
3011 k_name,
3012 name)));
3013 DEFVAR (name, scm_no_applicable_method);
3014 }
3015
3016 return SCM_UNSPECIFIED;
3017 }
3018
3019 void
3020 scm_init_goops ()
3021 {
3022 scm_c_define_gsubr ("%init-goops-builtins", 0, 0, 0,
3023 scm_init_goops_builtins);
3024 }
3025
3026 /*
3027 Local Variables:
3028 c-file-style: "gnu"
3029 End:
3030 */