1 ;;;; This file implements LOAD-TIME-VALUE.
3 ;;;; This software is part of the SBCL system. See the README file for
6 ;;;; This software is derived from the CMU CL system, which was
7 ;;;; written at Carnegie Mellon University and released into the
8 ;;;; public domain. The software is in the public domain and is
9 ;;;; provided with absolutely no warranty. See the COPYING and CREDITS
10 ;;;; files for more information.
14 (defknown %load-time-value (t) t (flushable movable))
16 (def-ir1-translator load-time-value
17 ((form &optional read-only-p) start next result)
19 "Arrange for FORM to be evaluated at load-time and use the value produced as
20 if it were a constant. If READ-ONLY-P is non-NIL, then the resultant object is
21 guaranteed to never be modified, so it can be put in read-only storage."
22 (let ((*allow-instrumenting* nil)
23 ;; First derive an approximate type from the source form, because it allows
24 ;; us to use READ-ONLY-P implicitly.
26 ;; We also use this type to augment whatever COMPILE-LOAD-TIME-VALUE
27 ;; returns -- in practice it returns *WILD-TYPE* all the time, but
28 ;; theoretically it could return something useful for the READ-ONLY-P case.
29 (source-type (single-value-type
31 (let ((op (car form)))
32 (cond ((member op '(the truly-the))
33 (values-specifier-type (second form)))
35 (specifier-type 'function))
36 ((and (legal-fun-name-p op)
37 (eq :declared (info :function :where-from op)))
38 (let ((ftype (info :function :type op)))
39 (if (fun-type-p ftype)
40 (fun-type-returns ftype)
45 (eq :declared (info :variable :where-from form)))
46 (info :variable :type form))
48 (ctype-of (eval form)))
51 ;; Implictly READ-ONLY-P for immutable objects.
52 (when (and (not read-only-p)
53 (csubtypep source-type (specifier-type '(or character number))))
55 (if (producing-fasl-file)
56 (multiple-value-bind (handle type)
57 ;; Value cells are allocated for non-READ-ONLY-P stop the
58 ;; compiler from complaining about constant modification
59 ;; -- it seems that we should be able to elide them all
60 ;; the time if we had a way of telling the compiler that
61 ;; "this object isn't really a constant the way you
62 ;; think". --NS 2009-06-28
63 (compile-load-time-value (if read-only-p
65 `(make-value-cell ,form)))
66 (unless (csubtypep type source-type)
67 (setf type source-type))
70 `(%load-time-value ',handle)
71 `(value-cell-ref (%load-time-value ',handle)))))
72 (the-in-policy type value-form '((type-check . 0))
75 (handler-case (eval form)
77 (compiler-error "(during EVAL of LOAD-TIME-VALUE)~%~A"
80 (ir1-convert start next result `',value nil)
81 (the-in-policy (ctype-of value) `(value-cell-ref ,(make-value-cell value))
83 start next result))))))
85 (defoptimizer (%load-time-value ir2-convert) ((handle) node block)
86 (aver (constant-lvar-p handle))
87 (let ((lvar (node-lvar node))
88 (tn (make-load-time-value-tn (lvar-value handle)
90 (move-lvar-result node block (list tn) lvar)))