1 ;;; byte-opt.el --- the optimization passes of the emacs-lisp byte compiler.
3 ;;; Copyright (c) 1991, 1994 Free Software Foundation, Inc.
5 ;; Author: Jamie Zawinski <jwz@lucid.com>
6 ;; Hallvard Furuseth <hbf@ulrik.uio.no>
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software; you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation; either version 2, or (at your option)
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs; see the file COPYING. If not, write to
23 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
27 ;;; ========================================================================
28 ;;; "No matter how hard you try, you can't make a racehorse out of a pig.
29 ;;; you can, however, make a faster pig."
31 ;;; Or, to put it another way, the emacs byte compiler is a VW Bug. This code
32 ;;; makes it be a VW Bug with fuel injection and a turbocharger... You're
33 ;;; still not going to make it go faster than 70 mph, but it might be easier
39 ;;; (apply '(lambda (x &rest y) ...) 1 (foo))
41 ;;; collapse common subexpressions
43 ;;; maintain a list of functions known not to access any global variables
44 ;;; (actually, give them a 'dynamically-safe property) and then
45 ;;; (let ( v1 v2 ... vM vN ) <...dynamically-safe...> ) ==>
46 ;;; (let ( v1 v2 ... vM ) vN <...dynamically-safe...> )
47 ;;; by recursing on this, we might be able to eliminate the entire let.
48 ;;; However certain variables should never have their bindings optimized
49 ;;; away, because they affect everything.
50 ;;; (put 'debug-on-error 'binding-is-magic t)
51 ;;; (put 'debug-on-abort 'binding-is-magic t)
52 ;;; (put 'inhibit-quit 'binding-is-magic t)
53 ;;; (put 'quit-flag 'binding-is-magic t)
56 ;;; Simple defsubsts often produce forms like
57 ;;; (let ((v1 (f1)) (v2 (f2)) ...)
59 ;;; It would be nice if we could optimize this to
60 ;;; (FN (f1) (f2) ...)
61 ;;; but we can't unless FN is dynamically-safe (it might be dynamically
62 ;;; referring to the bindings that the lambda arglist established.)
63 ;;; One of the uncountable lossages introduced by dynamic scope...
65 ;;; Maybe there should be a control-structure that says "turn on
66 ;;; fast-and-loose type-assumptive optimizations here." Then when
67 ;;; we see a form like (car foo) we can from then on assume that
68 ;;; the variable foo is of type cons, and optimize based on that.
69 ;;; But, this won't win much because of (you guessed it) dynamic
70 ;;; scope. Anything down the stack could change the value.
72 ;;; It would be nice if redundant sequences could be factored out as well,
73 ;;; when they are known to have no side-effects:
74 ;;; (list (+ a b c) (+ a b c)) --> a b add c add dup list-2
75 ;;; but beware of traps like
76 ;;; (cons (list x y) (list x y))
78 ;;; Tail-recursion elimination is not really possible in Emacs Lisp.
79 ;;; Tail-recursion elimination is almost always impossible when all variables
80 ;;; have dynamic scope, but given that the "return" byteop requires the
81 ;;; binding stack to be empty (rather than emptying it itself), there can be
82 ;;; no truly tail-recursive Emacs Lisp functions that take any arguments or
83 ;;; make any bindings.
85 ;;; Here is an example of an Emacs Lisp function which could safely be
86 ;;; byte-compiled tail-recursively:
88 ;;; (defun tail-map (fn list)
90 ;;; (funcall fn (car list))
91 ;;; (tail-map fn (cdr list)))))
93 ;;; However, if there was even a single let-binding around the COND,
94 ;;; it could not be byte-compiled, because there would be an "unbind"
95 ;;; byte-op between the final "call" and "return." Adding a
96 ;;; Bunbind_all byteop would fix this.
98 ;;; (defun foo (x y z) ... (foo a b c))
99 ;;; ... (const foo) (varref a) (varref b) (varref c) (call 3) END: (return)
100 ;;; ... (varref a) (varbind x) (varref b) (varbind y) (varref c) (varbind z) (goto 0) END: (unbind-all) (return)
101 ;;; ... (varref a) (varset x) (varref b) (varset y) (varref c) (varset z) (goto 0) END: (return)
103 ;;; this also can be considered tail recursion:
105 ;;; ... (const foo) (varref a) (call 1) (goto X) ... X: (return)
106 ;;; could generalize this by doing the optimization
107 ;;; (goto X) ... X: (return) --> (return)
109 ;;; But this doesn't solve all of the problems: although by doing tail-
110 ;;; recursion elimination in this way, the call-stack does not grow, the
111 ;;; binding-stack would grow with each recursive step, and would eventually
112 ;;; overflow. I don't believe there is any way around this without lexical
115 ;;; Wouldn't it be nice if Emacs Lisp had lexical scope.
117 ;;; Idea: the form (lexical-scope) in a file means that the file may be
118 ;;; compiled lexically. This proclamation is file-local. Then, within
119 ;;; that file, "let" would establish lexical bindings, and "let-dynamic"
120 ;;; would do things the old way. (Or we could use CL "declare" forms.)
121 ;;; We'd have to notice defvars and defconsts, since those variables should
122 ;;; always be dynamic, and attempting to do a lexical binding of them
123 ;;; should simply do a dynamic binding instead.
124 ;;; But! We need to know about variables that were not necessarily defvarred
125 ;;; in the file being compiled (doing a boundp check isn't good enough.)
126 ;;; Fdefvar() would have to be modified to add something to the plist.
128 ;;; A major disadvantage of this scheme is that the interpreter and compiler
129 ;;; would have different semantics for files compiled with (dynamic-scope).
130 ;;; Since this would be a file-local optimization, there would be no way to
131 ;;; modify the interpreter to obey this (unless the loader was hacked
132 ;;; in some grody way, but that's a really bad idea.)
134 ;;; Really the Right Thing is to make lexical scope the default across
135 ;;; the board, in the interpreter and compiler, and just FIX all of
136 ;;; the code that relies on dynamic scope of non-defvarred variables.
140 (defun byte-compile-log-lap-1 (format &rest args)
141 (if (aref byte-code-vector 0)
142 (error "The old version of the disassembler is loaded. Reload new-bytecomp as well."))
144 (apply 'format format
146 (mapcar '(lambda (arg)
147 (if (not (consp arg))
148 (if (and (symbolp arg)
149 (string-match "^byte-" (symbol-name arg)))
150 (intern (substring (symbol-name arg) 5))
152 (if (integerp (setq c (car arg)))
153 (error "non-symbolic byte-op %s" c))
156 (setq a (cond ((memq c byte-goto-ops)
157 (car (cdr (cdr arg))))
158 ((memq c byte-constref-ops)
161 (setq c (symbol-name c))
162 (if (string-match "^byte-." c)
163 (setq c (intern (substring c 5)))))
164 (if (eq c 'constant) (setq c 'const))
165 (if (and (eq (cdr arg) 0)
166 (not (memq c '(unbind call const))))
168 (format "(%s %s)" c a))))
171 (defmacro byte-compile-log-lap (format-string &rest args)
173 '(memq byte-optimize-log '(t byte))
174 (cons 'byte-compile-log-lap-1
175 (cons format-string args))))
178 ;;; byte-compile optimizers to support inlining
180 (put 'inline 'byte-optimizer 'byte-optimize-inline-handler)
182 (defun byte-optimize-inline-handler (form)
183 "byte-optimize-handler for the `inline' special-form."
187 (let ((fn (car-safe sexp)))
188 (if (and (symbolp fn)
189 (or (cdr (assq fn byte-compile-function-environment))
191 (not (or (cdr (assq fn byte-compile-macro-environment))
192 (and (consp (setq fn (symbol-function fn)))
193 (eq (car fn) 'macro))
195 (byte-compile-inline-expand sexp)
200 ;; Splice the given lap code into the current instruction stream.
201 ;; If it has any labels in it, you're responsible for making sure there
202 ;; are no collisions, and that byte-compile-tag-number is reasonable
203 ;; after this is spliced in. The provided list is destroyed.
204 (defun byte-inline-lapcode (lap)
205 (setq byte-compile-output (nconc (nreverse lap) byte-compile-output)))
208 (defun byte-compile-inline-expand (form)
209 (let* ((name (car form))
210 (fn (or (cdr (assq name byte-compile-function-environment))
211 (and (fboundp name) (symbol-function name)))))
214 (byte-compile-warn "attempt to inline %s before it was defined" name)
217 (if (and (consp fn) (eq (car fn) 'autoload))
219 (if (and (consp fn) (eq (car fn) 'autoload))
220 (error "file \"%s\" didn't define \"%s\"" (nth 1 fn) name))
222 (byte-compile-inline-expand (cons fn (cdr form)))
223 (if (byte-code-function-p fn)
226 (cons (list 'lambda (aref fn 0)
227 (list 'byte-code (aref fn 1) (aref fn 2) (aref fn 3)))
229 (if (not (eq (car fn) 'lambda)) (error "%s is not a lambda" name))
230 (cons fn (cdr form)))))))
232 ;;; ((lambda ...) ...)
234 (defun byte-compile-unfold-lambda (form &optional name)
235 (or name (setq name "anonymous lambda"))
236 (let ((lambda (car form))
238 (if (byte-code-function-p lambda)
239 (setq lambda (list 'lambda (aref lambda 0)
240 (list 'byte-code (aref lambda 1)
241 (aref lambda 2) (aref lambda 3)))))
242 (let ((arglist (nth 1 lambda))
243 (body (cdr (cdr lambda)))
246 (if (and (stringp (car body)) (cdr body))
247 (setq body (cdr body)))
248 (if (and (consp (car body)) (eq 'interactive (car (car body))))
249 (setq body (cdr body)))
251 (cond ((eq (car arglist) '&optional)
252 ;; ok, I'll let this slide because funcall_lambda() does...
253 ;; (if optionalp (error "multiple &optional keywords in %s" name))
254 (if restp (error "&optional found after &rest in %s" name))
255 (if (null (cdr arglist))
256 (error "nothing after &optional in %s" name))
258 ((eq (car arglist) '&rest)
259 ;; ...but it is by no stretch of the imagination a reasonable
260 ;; thing that funcall_lambda() allows (&rest x y) and
261 ;; (&rest x &optional y) in arglists.
262 (if (null (cdr arglist))
263 (error "nothing after &rest in %s" name))
264 (if (cdr (cdr arglist))
265 (error "multiple vars after &rest in %s" name))
268 (setq bindings (cons (list (car arglist)
269 (and values (cons 'list values)))
272 ((and (not optionalp) (null values))
273 (byte-compile-warn "attempt to open-code %s with too few arguments" name)
274 (setq arglist nil values 'too-few))
276 (setq bindings (cons (list (car arglist) (car values))
278 values (cdr values))))
279 (setq arglist (cdr arglist)))
282 (or (eq values 'too-few)
284 "attempt to open-code %s with too many arguments" name))
288 (cons 'let (cons (nreverse bindings) body))
289 (cons 'progn body))))
290 (byte-compile-log " %s\t==>\t%s" form newform)
294 ;;; implementing source-level optimizers
296 (defun byte-optimize-form-code-walker (form for-effect)
298 ;; For normal function calls, We can just mapcar the optimizer the cdr. But
299 ;; we need to have special knowledge of the syntax of the special forms
300 ;; like let and defun (that's why they're special forms :-). (Actually,
301 ;; the important aspect is that they are subrs that don't evaluate all of
304 (let ((fn (car-safe form))
306 (cond ((not (consp form))
307 (if (not (and for-effect
308 (or byte-compile-delete-errors
314 (byte-compile-warn "malformed quote form: %s"
315 (prin1-to-string form)))
316 ;; map (quote nil) to nil to simplify optimizer logic.
317 ;; map quoted constants to nil if for-effect (just because).
321 ((or (byte-code-function-p fn)
322 (eq 'lambda (car-safe fn)))
323 (byte-compile-unfold-lambda form))
324 ((memq fn '(let let*))
325 ;; recursively enter the optimizer for the bindings and body
326 ;; of a let or let*. This for depth-firstness: forms that
327 ;; are more deeply nested are optimized first.
330 (mapcar '(lambda (binding)
331 (if (symbolp binding)
333 (if (cdr (cdr binding))
334 (byte-compile-warn "malformed let binding: %s"
335 (prin1-to-string binding)))
337 (byte-optimize-form (nth 1 binding) nil))))
339 (byte-optimize-body (cdr (cdr form)) for-effect))))
342 (mapcar '(lambda (clause)
345 (byte-optimize-form (car clause) nil)
346 (byte-optimize-body (cdr clause) for-effect))
347 (byte-compile-warn "malformed cond form: %s"
348 (prin1-to-string clause))
352 ;; as an extra added bonus, this simplifies (progn <x>) --> <x>
355 (setq tmp (byte-optimize-body (cdr form) for-effect))
356 (if (cdr tmp) (cons 'progn tmp) (car tmp)))
357 (byte-optimize-form (nth 1 form) for-effect)))
361 (cons (byte-optimize-form (nth 1 form) for-effect)
362 (byte-optimize-body (cdr (cdr form)) t)))
363 (byte-optimize-form (nth 1 form) for-effect)))
366 (cons (byte-optimize-form (nth 1 form) t)
367 (cons (byte-optimize-form (nth 2 form) for-effect)
368 (byte-optimize-body (cdr (cdr (cdr form))) t)))))
370 ((memq fn '(save-excursion save-restriction))
371 ;; those subrs which have an implicit progn; it's not quite good
372 ;; enough to treat these like normal function calls.
373 ;; This can turn (save-excursion ...) into (save-excursion) which
374 ;; will be optimized away in the lap-optimize pass.
375 (cons fn (byte-optimize-body (cdr form) for-effect)))
377 ((eq fn 'with-output-to-temp-buffer)
378 ;; this is just like the above, except for the first argument.
381 (byte-optimize-form (nth 1 form) nil)
382 (byte-optimize-body (cdr (cdr form)) for-effect))))
386 (cons (byte-optimize-form (nth 1 form) nil)
388 (byte-optimize-form (nth 2 form) for-effect)
389 (byte-optimize-body (nthcdr 3 form) for-effect)))))
391 ((memq fn '(and or)) ; remember, and/or are control structures.
392 ;; take forms off the back until we can't any more.
393 ;; In the future it could conceivably be a problem that the
394 ;; subexpressions of these forms are optimized in the reverse
395 ;; order, but it's ok for now.
397 (let ((backwards (reverse (cdr form))))
398 (while (and backwards
399 (null (setcar backwards
400 (byte-optimize-form (car backwards)
402 (setq backwards (cdr backwards)))
403 (if (and (cdr form) (null backwards))
405 " all subforms of %s called for effect; deleted" form))
407 (cons fn (nreverse backwards))))
408 (cons fn (mapcar 'byte-optimize-form (cdr form)))))
410 ((eq fn 'interactive)
411 (byte-compile-warn "misplaced interactive spec: %s"
412 (prin1-to-string form))
415 ((memq fn '(defun defmacro function
416 condition-case save-window-excursion))
417 ;; These forms are compiled as constants or by breaking out
418 ;; all the subexpressions and compiling them separately.
421 ((eq fn 'unwind-protect)
422 ;; the "protected" part of an unwind-protect is compiled (and thus
423 ;; optimized) as a top-level form, so don't do it here. But the
424 ;; non-protected part has the same for-effect status as the
425 ;; unwind-protect itself. (The protected part is always for effect,
426 ;; but that isn't handled properly yet.)
428 (cons (byte-optimize-form (nth 1 form) for-effect)
432 ;; the body of a catch is compiled (and thus optimized) as a
433 ;; top-level form, so don't do it here. The tag is never
434 ;; for-effect. The body should have the same for-effect status
435 ;; as the catch form itself, but that isn't handled properly yet.
437 (cons (byte-optimize-form (nth 1 form) nil)
440 ;; If optimization is on, this is the only place that macros are
441 ;; expanded. If optimization is off, then macroexpansion happens
442 ;; in byte-compile-form. Otherwise, the macros are already expanded
443 ;; by the time that is reached.
445 (setq form (macroexpand form
446 byte-compile-macro-environment))))
447 (byte-optimize-form form for-effect))
450 (or (eq 'mocklisp (car-safe fn)) ; ha!
451 (byte-compile-warn "%s is a malformed function"
452 (prin1-to-string fn)))
455 ((and for-effect (setq tmp (get fn 'side-effect-free))
456 (or byte-compile-delete-errors
459 (byte-compile-warn "%s called for effect"
460 (prin1-to-string form))
462 (byte-compile-log " %s called for effect; deleted" fn)
463 ;; appending a nil here might not be necessary, but it can't hurt.
465 (cons 'progn (append (cdr form) '(nil))) t))
468 ;; Otherwise, no args can be considered to be for-effect,
469 ;; even if the called function is for-effect, because we
470 ;; don't know anything about that function.
471 (cons fn (mapcar 'byte-optimize-form (cdr form)))))))
474 (defun byte-optimize-form (form &optional for-effect)
475 "The source-level pass of the optimizer."
477 ;; First, optimize all sub-forms of this one.
478 (setq form (byte-optimize-form-code-walker form for-effect))
480 ;; after optimizing all subforms, optimize this form until it doesn't
481 ;; optimize any further. This means that some forms will be passed through
482 ;; the optimizer many times, but that's necessary to make the for-effect
483 ;; processing do as much as possible.
486 (if (and (consp form)
489 ;; we don't have any of these yet, but we might.
490 (setq opt (get (car form) 'byte-for-effect-optimizer)))
491 (setq opt (get (car form) 'byte-optimizer)))
492 (not (eq form (setq new (funcall opt form)))))
494 ;; (if (equal form new) (error "bogus optimizer -- %s" opt))
495 (byte-compile-log " %s\t==>\t%s" form new)
496 (setq new (byte-optimize-form new for-effect))
501 (defun byte-optimize-body (forms all-for-effect)
502 ;; optimize the cdr of a progn or implicit progn; all forms is a list of
503 ;; forms, all but the last of which are optimized with the assumption that
504 ;; they are being called for effect. the last is for-effect as well if
505 ;; all-for-effect is true. returns a new list of forms.
510 (setq fe (or all-for-effect (cdr rest)))
511 (setq new (and (car rest) (byte-optimize-form (car rest) fe)))
512 (if (or new (not fe))
513 (setq result (cons new result)))
514 (setq rest (cdr rest)))
518 ;;; some source-level optimizers
520 ;;; when writing optimizers, be VERY careful that the optimizer returns
521 ;;; something not EQ to its argument if and ONLY if it has made a change.
522 ;;; This implies that you cannot simply destructively modify the list;
523 ;;; you must return something not EQ to it if you make an optimization.
525 ;;; It is now safe to optimize code such that it introduces new bindings.
527 ;; I'd like this to be a defsubst, but let's not be self-referential...
528 (defmacro byte-compile-trueconstp (form)
529 ;; Returns non-nil if FORM is a non-nil constant.
530 (` (cond ((consp (, form)) (eq (car (, form)) 'quote))
531 ((not (symbolp (, form))))
534 ;; If the function is being called with constant numeric args,
535 ;; evaluate as much as possible at compile-time. This optimizer
536 ;; assumes that the function is associative, like + or *.
537 (defun byte-optimize-associative-math (form)
542 (if (numberp (car rest))
543 (setq constants (cons (car rest) constants))
544 (setq args (cons (car rest) args)))
545 (setq rest (cdr rest)))
549 (apply (car form) constants)
551 (cons (car form) (nreverse args))
553 (apply (car form) constants))
556 ;; If the function is being called with constant numeric args,
557 ;; evaluate as much as possible at compile-time. This optimizer
558 ;; assumes that the function is nonassociative, like - or /.
559 (defun byte-optimize-nonassociative-math (form)
560 (if (or (not (numberp (car (cdr form))))
561 (not (numberp (car (cdr (cdr form))))))
563 (let ((constant (car (cdr form)))
564 (rest (cdr (cdr form))))
565 (while (numberp (car rest))
566 (setq constant (funcall (car form) constant (car rest))
569 (cons (car form) (cons constant rest))
572 ;;(defun byte-optimize-associative-two-args-math (form)
573 ;; (setq form (byte-optimize-associative-math form))
575 ;; (byte-optimize-two-args-left form)
578 ;;(defun byte-optimize-nonassociative-two-args-math (form)
579 ;; (setq form (byte-optimize-nonassociative-math form))
581 ;; (byte-optimize-two-args-right form)
584 (defun byte-optimize-delay-constants-math (form start fun)
585 ;; Merge all FORM's constants from number START, call FUN on them
586 ;; and put the result at the end.
587 (let ((rest (nthcdr (1- start) form)))
588 (while (cdr (setq rest (cdr rest)))
589 (if (numberp (car rest))
591 (setq form (copy-sequence form)
592 rest (nthcdr (1- start) form))
593 (while (setq rest (cdr rest))
594 (cond ((numberp (car rest))
595 (setq constants (cons (car rest) constants))
597 (setq form (nconc (delq nil form)
598 (list (apply fun (nreverse constants))))))))
601 (defun byte-optimize-plus (form)
602 (setq form (byte-optimize-delay-constants-math form 1 '+))
603 (if (memq 0 form) (setq form (delq 0 (copy-sequence form))))
604 ;;(setq form (byte-optimize-associative-two-args-math form))
605 (cond ((null (cdr form))
609 ;;; It is not safe to delete the function entirely
610 ;;; (actually, it would be safe if we know the sole arg
611 ;;; is not a marker).
612 ;; ((null (cdr (cdr form))) (nth 1 form))
615 (defun byte-optimize-minus (form)
616 ;; Put constants at the end, except the last constant.
617 (setq form (byte-optimize-delay-constants-math form 2 '+))
618 ;; Now only first and last element can be a number.
619 (let ((last (car (reverse (nthcdr 3 form)))))
621 ;; (- x y ... 0) --> (- x y ...)
622 (setq form (copy-sequence form))
623 (setcdr (cdr (cdr form)) (delq 0 (nthcdr 3 form))))
624 ;; If form is (- CONST foo... CONST), merge first and last.
625 ((and (numberp (nth 1 form))
627 (setq form (nconc (list '- (- (nth 1 form) last) (nth 2 form))
628 (delq last (copy-sequence (nthcdr 3 form))))))))
629 ;;; It is not safe to delete the function entirely
630 ;;; (actually, it would be safe if we know the sole arg
631 ;;; is not a marker).
632 ;;; (if (eq (nth 2 form) 0)
633 ;;; (nth 1 form) ; (- x 0) --> x
634 (byte-optimize-predicate
635 (if (and (null (cdr (cdr (cdr form))))
636 (eq (nth 1 form) 0)) ; (- 0 x) --> (- x)
637 (cons (car form) (cdr (cdr form)))
642 (defun byte-optimize-multiply (form)
643 (setq form (byte-optimize-delay-constants-math form 1 '*))
644 ;; If there is a constant in FORM, it is now the last element.
645 (cond ((null (cdr form)) 1)
646 ;;; It is not safe to delete the function entirely
647 ;;; (actually, it would be safe if we know the sole arg
648 ;;; is not a marker or if it appears in other arithmetic).
649 ;;; ((null (cdr (cdr form))) (nth 1 form))
650 ((let ((last (car (reverse form))))
651 (cond ((eq 0 last) (list 'progn (cdr form)))
652 ((eq 1 last) (delq 1 (copy-sequence form)))
653 ((eq -1 last) (list '- (delq -1 (copy-sequence form))))
655 (memq t (mapcar 'symbolp (cdr form))))
656 (prog1 (setq form (delq 2 (copy-sequence form)))
657 (while (not (symbolp (car (setq form (cdr form))))))
658 (setcar form (list '+ (car form) (car form)))))
661 (defsubst byte-compile-butlast (form)
662 (nreverse (cdr (reverse form))))
664 (defun byte-optimize-divide (form)
665 (setq form (byte-optimize-delay-constants-math form 2 '*))
666 (let ((last (car (reverse (cdr (cdr form))))))
668 (cond ((= (length form) 3)
669 ;; Don't shrink to less than two arguments--would get an error.
672 (setq form (byte-compile-butlast form)))
673 ((numberp (nth 1 form))
674 (setq form (cons (car form)
675 (cons (/ (nth 1 form) last)
676 (byte-compile-butlast (cdr (cdr form)))))
679 ;;; ((null (cdr (cdr form)))
682 (append '(progn) (cdr (cdr form)) '(0)))
684 (list '- (if (nthcdr 3 form)
685 (byte-compile-butlast form)
689 (defun byte-optimize-logmumble (form)
690 (setq form (byte-optimize-delay-constants-math form 1 (car form)))
691 (byte-optimize-predicate
693 (setq form (if (eq (car form) 'logand)
694 (cons 'progn (cdr form))
695 (delq 0 (copy-sequence form)))))
696 ((and (eq (car-safe form) 'logior)
698 (delq -1 (copy-sequence form)))
702 (defun byte-optimize-binary-predicate (form)
703 (if (byte-compile-constp (nth 1 form))
704 (if (byte-compile-constp (nth 2 form))
706 (list 'quote (eval form))
708 ;; This can enable some lapcode optimizations.
709 (list (car form) (nth 2 form) (nth 1 form)))
712 (defun byte-optimize-predicate (form)
716 (setq ok (byte-compile-constp (car rest))
720 (list 'quote (eval form))
724 (defun byte-optimize-identity (form)
725 (if (and (cdr form) (null (cdr (cdr form))))
727 (byte-compile-warn "identity called with %d arg%s, but requires 1"
729 (if (= 1 (length (cdr form))) "" "s"))
732 (put 'identity 'byte-optimizer 'byte-optimize-identity)
734 (put '+ 'byte-optimizer 'byte-optimize-plus)
735 (put '* 'byte-optimizer 'byte-optimize-multiply)
736 (put '- 'byte-optimizer 'byte-optimize-minus)
737 (put '/ 'byte-optimizer 'byte-optimize-divide)
738 (put 'max 'byte-optimizer 'byte-optimize-associative-math)
739 (put 'min 'byte-optimizer 'byte-optimize-associative-math)
741 (put '= 'byte-optimizer 'byte-optimize-binary-predicate)
742 (put 'eq 'byte-optimizer 'byte-optimize-binary-predicate)
743 (put 'eql 'byte-optimizer 'byte-optimize-binary-predicate)
744 (put 'equal 'byte-optimizer 'byte-optimize-binary-predicate)
745 (put 'string= 'byte-optimizer 'byte-optimize-binary-predicate)
746 (put 'string-equal 'byte-optimizer 'byte-optimize-binary-predicate)
748 (put '< 'byte-optimizer 'byte-optimize-predicate)
749 (put '> 'byte-optimizer 'byte-optimize-predicate)
750 (put '<= 'byte-optimizer 'byte-optimize-predicate)
751 (put '>= 'byte-optimizer 'byte-optimize-predicate)
752 (put '1+ 'byte-optimizer 'byte-optimize-predicate)
753 (put '1- 'byte-optimizer 'byte-optimize-predicate)
754 (put 'not 'byte-optimizer 'byte-optimize-predicate)
755 (put 'null 'byte-optimizer 'byte-optimize-predicate)
756 (put 'memq 'byte-optimizer 'byte-optimize-predicate)
757 (put 'consp 'byte-optimizer 'byte-optimize-predicate)
758 (put 'listp 'byte-optimizer 'byte-optimize-predicate)
759 (put 'symbolp 'byte-optimizer 'byte-optimize-predicate)
760 (put 'stringp 'byte-optimizer 'byte-optimize-predicate)
761 (put 'string< 'byte-optimizer 'byte-optimize-predicate)
762 (put 'string-lessp 'byte-optimizer 'byte-optimize-predicate)
764 (put 'logand 'byte-optimizer 'byte-optimize-logmumble)
765 (put 'logior 'byte-optimizer 'byte-optimize-logmumble)
766 (put 'logxor 'byte-optimizer 'byte-optimize-logmumble)
767 (put 'lognot 'byte-optimizer 'byte-optimize-predicate)
769 (put 'car 'byte-optimizer 'byte-optimize-predicate)
770 (put 'cdr 'byte-optimizer 'byte-optimize-predicate)
771 (put 'car-safe 'byte-optimizer 'byte-optimize-predicate)
772 (put 'cdr-safe 'byte-optimizer 'byte-optimize-predicate)
775 ;; I'm not convinced that this is necessary. Doesn't the optimizer loop
776 ;; take care of this? - Jamie
777 ;; I think this may some times be necessary to reduce ie (quote 5) to 5,
778 ;; so arithmetic optimizers recognize the numeric constant. - Hallvard
779 (put 'quote 'byte-optimizer 'byte-optimize-quote)
780 (defun byte-optimize-quote (form)
781 (if (or (consp (nth 1 form))
782 (and (symbolp (nth 1 form))
783 (not (memq (nth 1 form) '(nil t)))))
787 (defun byte-optimize-zerop (form)
788 (cond ((numberp (nth 1 form))
790 (byte-compile-delete-errors
791 (list '= (nth 1 form) 0))
794 (put 'zerop 'byte-optimizer 'byte-optimize-zerop)
796 (defun byte-optimize-and (form)
797 ;; Simplify if less than 2 args.
798 ;; if there is a literal nil in the args to `and', throw it and following
799 ;; forms away, and surround the `and' with (progn ... nil).
800 (cond ((null (cdr form)))
804 (prog1 (setq form (copy-sequence form))
806 (setq form (cdr form)))
809 ((null (cdr (cdr form)))
811 ((byte-optimize-predicate form))))
813 (defun byte-optimize-or (form)
814 ;; Throw away nil's, and simplify if less than 2 args.
815 ;; If there is a literal non-nil constant in the args to `or', throw away all
818 (setq form (delq nil (copy-sequence form))))
820 (while (cdr (setq rest (cdr rest)))
821 (if (byte-compile-trueconstp (car rest))
822 (setq form (copy-sequence form)
823 rest (setcdr (memq (car rest) form) nil))))
825 (byte-optimize-predicate form)
828 (defun byte-optimize-cond (form)
829 ;; if any clauses have a literal nil as their test, throw them away.
830 ;; if any clause has a literal non-nil constant as its test, throw
831 ;; away all following clauses.
833 ;; This must be first, to reduce (cond (t ...) (nil)) to (progn t ...)
834 (while (setq rest (assq nil (cdr form)))
835 (setq form (delq rest (copy-sequence form))))
836 (if (memq nil (cdr form))
837 (setq form (delq nil (copy-sequence form))))
839 (while (setq rest (cdr rest))
840 (cond ((byte-compile-trueconstp (car-safe (car rest)))
841 (cond ((eq rest (cdr form))
844 (if (cdr (cdr (car rest)))
845 (cons 'progn (cdr (car rest)))
849 (setq form (copy-sequence form))
850 (setcdr (memq (car rest) form) nil)))
853 ;; Turn (cond (( <x> )) ... ) into (or <x> (cond ... ))
854 (if (eq 'cond (car-safe form))
855 (let ((clauses (cdr form)))
856 (if (and (consp (car clauses))
857 (null (cdr (car clauses))))
858 (list 'or (car (car clauses))
860 (cons (car form) (cdr (cdr form)))))
864 (defun byte-optimize-if (form)
865 ;; (if <true-constant> <then> <else...>) ==> <then>
866 ;; (if <false-constant> <then> <else...>) ==> (progn <else...>)
867 ;; (if <test> nil <else...>) ==> (if (not <test>) (progn <else...>))
868 ;; (if <test> <then> nil) ==> (if <test> <then>)
869 (let ((clause (nth 1 form)))
870 (cond ((byte-compile-trueconstp clause)
874 (cons 'progn (nthcdr 3 form))
877 (if (equal '(nil) (nthcdr 3 form))
878 (list 'if clause (nth 2 form))
880 ((or (nth 3 form) (nthcdr 4 form))
881 (list 'if (list 'not clause)
883 (cons 'progn (nthcdr 3 form))
886 (list 'progn clause nil)))))
888 (defun byte-optimize-while (form)
892 (put 'and 'byte-optimizer 'byte-optimize-and)
893 (put 'or 'byte-optimizer 'byte-optimize-or)
894 (put 'cond 'byte-optimizer 'byte-optimize-cond)
895 (put 'if 'byte-optimizer 'byte-optimize-if)
896 (put 'while 'byte-optimizer 'byte-optimize-while)
898 ;; byte-compile-negation-optimizer lives in bytecomp.el
899 (put '/= 'byte-optimizer 'byte-compile-negation-optimizer)
900 (put 'atom 'byte-optimizer 'byte-compile-negation-optimizer)
901 (put 'nlistp 'byte-optimizer 'byte-compile-negation-optimizer)
904 (defun byte-optimize-funcall (form)
905 ;; (funcall '(lambda ...) ...) ==> ((lambda ...) ...)
906 ;; (funcall 'foo ...) ==> (foo ...)
907 (let ((fn (nth 1 form)))
908 (if (memq (car-safe fn) '(quote function))
909 (cons (nth 1 fn) (cdr (cdr form)))
912 (defun byte-optimize-apply (form)
913 ;; If the last arg is a literal constant, turn this into a funcall.
914 ;; The funcall optimizer can then transform (funcall 'foo ...) -> (foo ...).
915 (let ((fn (nth 1 form))
916 (last (nth (1- (length form)) form))) ; I think this really is fastest
917 (or (if (or (null last)
918 (eq (car-safe last) 'quote))
919 (if (listp (nth 1 last))
920 (let ((butlast (nreverse (cdr (reverse (cdr (cdr form)))))))
921 (nconc (list 'funcall fn) butlast
922 (mapcar '(lambda (x) (list 'quote x)) (nth 1 last))))
924 "last arg to apply can't be a literal atom: %s"
925 (prin1-to-string last))
929 (put 'funcall 'byte-optimizer 'byte-optimize-funcall)
930 (put 'apply 'byte-optimizer 'byte-optimize-apply)
933 (put 'let 'byte-optimizer 'byte-optimize-letX)
934 (put 'let* 'byte-optimizer 'byte-optimize-letX)
935 (defun byte-optimize-letX (form)
936 (cond ((null (nth 1 form))
938 (cons 'progn (cdr (cdr form))))
939 ((or (nth 2 form) (nthcdr 3 form))
942 ((eq (car form) 'let)
943 (append '(progn) (mapcar 'car-safe (mapcar 'cdr-safe (nth 1 form)))
946 (let ((binds (reverse (nth 1 form))))
947 (list 'let* (reverse (cdr binds)) (nth 1 (car binds)) nil)))))
950 (put 'nth 'byte-optimizer 'byte-optimize-nth)
951 (defun byte-optimize-nth (form)
952 (if (memq (nth 1 form) '(0 1))
953 (list 'car (if (zerop (nth 1 form))
955 (list 'cdr (nth 2 form))))
956 (byte-optimize-predicate form)))
958 (put 'nthcdr 'byte-optimizer 'byte-optimize-nthcdr)
959 (defun byte-optimize-nthcdr (form)
960 (let ((count (nth 1 form)))
961 (if (not (memq count '(0 1 2)))
962 (byte-optimize-predicate form)
963 (setq form (nth 2 form))
964 (while (natnump (setq count (1- count)))
965 (setq form (list 'cdr form)))
968 ;;; enumerating those functions which need not be called if the returned
969 ;;; value is not used. That is, something like
970 ;;; (progn (list (something-with-side-effects) (yow))
972 ;;; may safely be turned into
973 ;;; (progn (progn (something-with-side-effects) (yow))
975 ;;; Further optimizations will turn (progn (list 1 2 3) 'foo) into 'foo.
977 ;;; I wonder if I missed any :-\)
978 (let ((side-effect-free-fns
979 '(% * + - / /= 1+ 1- < <= = > >= abs acos append aref ash asin atan
981 boundp buffer-file-name buffer-local-variables buffer-modified-p
983 capitalize car-less-than-car car cdr ceiling concat coordinates-in-window-p
984 copy-marker cos count-lines
985 default-boundp default-value documentation downcase
986 elt exp expt fboundp featurep
987 file-directory-p file-exists-p file-locked-p file-name-absolute-p
988 file-newer-than-file-p file-readable-p file-symlink-p file-writable-p
990 get get-buffer get-buffer-window getenv get-file-buffer
992 length log log10 logand logb logior lognot logxor lsh
993 marker-buffer max member memq min mod
994 next-window nth nthcdr number-to-string
995 parse-colon-path previous-window
996 radians-to-degrees rassq regexp-quote reverse round
997 sin sqrt string< string= string-equal string-lessp string-to-char
998 string-to-int string-to-number substring symbol-plist
999 tan upcase user-variable-p vconcat
1000 window-buffer window-dedicated-p window-edges window-height
1001 window-hscroll window-minibuffer-p window-width
1003 (side-effect-and-error-free-fns
1005 bobp bolp buffer-end buffer-list buffer-size buffer-string bufferp
1006 car-safe case-table-p cdr-safe char-or-string-p commandp cons consp
1008 dot dot-marker eobp eolp eq eql equal eventp floatp framep
1009 get-largest-window get-lru-window
1010 identity ignore integerp integer-or-marker-p interactive-p
1011 invocation-directory invocation-name
1013 make-marker mark mark-marker markerp memory-limit minibuffer-window
1015 natnump nlistp not null number-or-marker-p numberp
1016 one-window-p overlayp
1017 point point-marker point-min point-max processp
1018 selected-window sequencep stringp subrp symbolp syntax-table-p
1019 user-full-name user-login-name user-original-login-name
1020 user-real-login-name user-real-uid user-uid
1022 window-configuration-p window-live-p windowp)))
1023 (while side-effect-free-fns
1024 (put (car side-effect-free-fns) 'side-effect-free t)
1025 (setq side-effect-free-fns (cdr side-effect-free-fns)))
1026 (while side-effect-and-error-free-fns
1027 (put (car side-effect-and-error-free-fns) 'side-effect-free 'error-free)
1028 (setq side-effect-and-error-free-fns (cdr side-effect-and-error-free-fns)))
1032 (defun byte-compile-splice-in-already-compiled-code (form)
1033 ;; form is (byte-code "..." [...] n)
1034 (if (not (memq byte-optimize '(t lap)))
1035 (byte-compile-normal-call form)
1036 (byte-inline-lapcode
1037 (byte-decompile-bytecode-1 (nth 1 form) (nth 2 form) t))
1038 (setq byte-compile-maxdepth (max (+ byte-compile-depth (nth 3 form))
1039 byte-compile-maxdepth))
1040 (setq byte-compile-depth (1+ byte-compile-depth))))
1042 (put 'byte-code 'byte-compile 'byte-compile-splice-in-already-compiled-code)
1045 (defconst byte-constref-ops
1046 '(byte-constant byte-constant2 byte-varref byte-varset byte-varbind))
1048 ;;; This function extracts the bitfields from variable-length opcodes.
1049 ;;; Originally defined in disass.el (which no longer uses it.)
1051 (defun disassemble-offset ()
1053 ;; fetch and return the offset for the current opcode.
1054 ;; return NIL if this opcode has no offset
1055 ;; OP, PTR and BYTES are used and set dynamically
1059 (cond ((< op byte-nth)
1060 (let ((tem (logand op 7)))
1061 (setq op (logand op 248))
1063 (setq ptr (1+ ptr)) ;offset in next byte
1066 (setq ptr (1+ ptr)) ;offset in next 2 bytes
1068 (progn (setq ptr (1+ ptr))
1069 (lsh (aref bytes ptr) 8))))
1070 (t tem)))) ;offset was in opcode
1071 ((>= op byte-constant)
1072 (prog1 (- op byte-constant) ;offset in opcode
1073 (setq op byte-constant)))
1074 ((and (>= op byte-constant2)
1075 (<= op byte-goto-if-not-nil-else-pop))
1076 (setq ptr (1+ ptr)) ;offset in next 2 bytes
1078 (progn (setq ptr (1+ ptr))
1079 (lsh (aref bytes ptr) 8))))
1080 ((and (>= op byte-listN)
1081 (<= op byte-insertN))
1082 (setq ptr (1+ ptr)) ;offset in next byte
1086 ;;; This de-compiler is used for inline expansion of compiled functions,
1087 ;;; and by the disassembler.
1089 ;;; This list contains numbers, which are pc values,
1090 ;;; before each instruction.
1091 (defun byte-decompile-bytecode (bytes constvec)
1092 "Turns BYTECODE into lapcode, referring to CONSTVEC."
1093 (let ((byte-compile-constants nil)
1094 (byte-compile-variables nil)
1095 (byte-compile-tag-number 0))
1096 (byte-decompile-bytecode-1 bytes constvec)))
1098 ;; As byte-decompile-bytecode, but updates
1099 ;; byte-compile-{constants, variables, tag-number}.
1100 ;; If MAKE-SPLICEABLE is true, then `return' opcodes are replaced
1101 ;; with `goto's destined for the end of the code.
1102 ;; That is for use by the compiler.
1103 ;; If MAKE-SPLICEABLE is nil, we are being called for the disassembler.
1104 ;; In that case, we put a pc value into the list
1105 ;; before each insn (or its label).
1106 (defun byte-decompile-bytecode-1 (bytes constvec &optional make-spliceable)
1107 (let ((length (length bytes))
1108 (ptr 0) optr tag tags op offset
1112 (while (not (= ptr length))
1114 (setq lap (cons ptr lap)))
1115 (setq op (aref bytes ptr)
1117 offset (disassemble-offset)) ; this does dynamic-scope magic
1118 (setq op (aref byte-code-vector op))
1119 (cond ((memq op byte-goto-ops)
1122 (cdr (or (assq offset tags)
1125 (byte-compile-make-tag))
1127 ((cond ((eq op 'byte-constant2) (setq op 'byte-constant) t)
1128 ((memq op byte-constref-ops)))
1129 (setq tmp (aref constvec offset)
1130 offset (if (eq op 'byte-constant)
1131 (byte-compile-get-constant tmp)
1132 (or (assq tmp byte-compile-variables)
1133 (car (setq byte-compile-variables
1135 byte-compile-variables)))))))
1136 ((and make-spliceable
1137 (eq op 'byte-return))
1138 (if (= ptr (1- length))
1140 (setq offset (or endtag (setq endtag (byte-compile-make-tag)))
1142 ;; lap = ( [ (pc . (op . arg)) ]* )
1143 (setq lap (cons (cons optr (cons op (or offset 0)))
1145 (setq ptr (1+ ptr)))
1146 ;; take off the dummy nil op that we replaced a trailing "return" with.
1149 (cond ((numberp (car rest)))
1150 ((setq tmp (assq (car (car rest)) tags))
1151 ;; this addr is jumped to
1152 (setcdr rest (cons (cons nil (cdr tmp))
1154 (setq tags (delq tmp tags))
1155 (setq rest (cdr rest))))
1156 (setq rest (cdr rest))))
1157 (if tags (error "optimizer error: missed tags %s" tags))
1158 (if (null (car (cdr (car lap))))
1159 (setq lap (cdr lap)))
1161 (setq lap (cons (cons nil endtag) lap)))
1162 ;; remove addrs, lap = ( [ (op . arg) | (TAG tagno) ]* )
1163 (mapcar (function (lambda (elt)
1170 ;;; peephole optimizer
1172 (defconst byte-tagref-ops (cons 'TAG byte-goto-ops))
1174 (defconst byte-conditional-ops
1175 '(byte-goto-if-nil byte-goto-if-not-nil byte-goto-if-nil-else-pop
1176 byte-goto-if-not-nil-else-pop))
1178 (defconst byte-after-unbind-ops
1179 '(byte-constant byte-dup
1180 byte-symbolp byte-consp byte-stringp byte-listp byte-numberp byte-integerp
1181 byte-eq byte-equal byte-not
1182 byte-cons byte-list1 byte-list2 ; byte-list3 byte-list4
1184 ;; How about other side-effect-free-ops? Is it safe to move an
1185 ;; error invocation (such as from nth) out of an unwind-protect?
1186 "Byte-codes that can be moved past an unbind.")
1188 (defconst byte-compile-side-effect-and-error-free-ops
1189 '(byte-constant byte-dup byte-symbolp byte-consp byte-stringp byte-listp
1190 byte-integerp byte-numberp byte-eq byte-equal byte-not byte-car-safe
1191 byte-cdr-safe byte-cons byte-list1 byte-list2 byte-point byte-point-max
1192 byte-point-min byte-following-char byte-preceding-char
1193 byte-current-column byte-eolp byte-eobp byte-bolp byte-bobp
1194 byte-current-buffer byte-interactive-p))
1196 (defconst byte-compile-side-effect-free-ops
1198 '(byte-varref byte-nth byte-memq byte-car byte-cdr byte-length byte-aref
1199 byte-symbol-value byte-get byte-concat2 byte-concat3 byte-sub1 byte-add1
1200 byte-eqlsign byte-gtr byte-lss byte-leq byte-geq byte-diff byte-negate
1201 byte-plus byte-max byte-min byte-mult byte-char-after byte-char-syntax
1202 byte-buffer-substring byte-string= byte-string< byte-nthcdr byte-elt
1203 byte-member byte-assq byte-quo byte-rem)
1204 byte-compile-side-effect-and-error-free-ops))
1206 ;;; This piece of shit is because of the way DEFVAR_BOOL() variables work.
1207 ;;; Consider the code
1209 ;;; (defun foo (flag)
1210 ;;; (let ((old-pop-ups pop-up-windows)
1211 ;;; (pop-up-windows flag))
1212 ;;; (cond ((not (eq pop-up-windows old-pop-ups))
1213 ;;; (setq old-pop-ups pop-up-windows)
1216 ;;; Uncompiled, old-pop-ups will always be set to nil or t, even if FLAG is
1217 ;;; something else. But if we optimize
1220 ;;; varbind pop-up-windows
1221 ;;; varref pop-up-windows
1226 ;;; varbind pop-up-windows
1229 ;;; we break the program, because it will appear that pop-up-windows and
1230 ;;; old-pop-ups are not EQ when really they are. So we have to know what
1231 ;;; the BOOL variables are, and not perform this optimization on them.
1233 (defconst byte-boolean-vars
1234 '(abbrev-all-caps abbrevs-changed byte-metering-on
1235 check-protected-fields completion-auto-help completion-ignore-case
1236 cursor-in-echo-area debug-on-next-call debug-on-quit
1237 defining-kbd-macro delete-exited-processes
1238 enable-recursive-minibuffers
1239 highlight-nonselected-windows indent-tabs-mode
1240 insert-default-directory inverse-video load-in-progress
1241 menu-prompting mode-line-inverse-video no-redraw-on-reenter
1242 noninteractive parse-sexp-ignore-comments pop-up-frames
1243 pop-up-windows print-escape-newlines print-escape-newlines
1244 truncate-partial-width-windows visible-bell vms-stmlf-recfm
1245 words-include-escapes x-save-under)
1246 "DEFVAR_BOOL variables. Giving these any non-nil value sets them to t.
1247 If this does not enumerate all DEFVAR_BOOL variables, the byte-optimizer
1248 may generate incorrect code.")
1250 (defun byte-optimize-lapcode (lap &optional for-effect)
1251 "Simple peephole optimizer. LAP is both modified and returned."
1255 (keep-going 'first-time)
1258 (side-effect-free (if byte-compile-delete-errors
1259 byte-compile-side-effect-free-ops
1260 byte-compile-side-effect-and-error-free-ops)))
1262 (or (eq keep-going 'first-time)
1263 (byte-compile-log-lap " ---- next pass"))
1267 (setq lap0 (car rest)
1271 ;; You may notice that sequences like "dup varset discard" are
1272 ;; optimized but sequences like "dup varset TAG1: discard" are not.
1273 ;; You may be tempted to change this; resist that temptation.
1275 ;; <side-effect-free> pop --> <deleted>
1277 ;; const-X pop --> <deleted>
1278 ;; varref-X pop --> <deleted>
1279 ;; dup pop --> <deleted>
1281 ((and (eq 'byte-discard (car lap1))
1282 (memq (car lap0) side-effect-free))
1284 (setq tmp (aref byte-stack+-info (symbol-value (car lap0))))
1285 (setq rest (cdr rest))
1287 (byte-compile-log-lap
1288 " %s discard\t-->\t<deleted>" lap0)
1289 (setq lap (delq lap0 (delq lap1 lap))))
1291 (byte-compile-log-lap
1292 " %s discard\t-->\t<deleted> discard" lap0)
1293 (setq lap (delq lap0 lap)))
1295 (byte-compile-log-lap
1296 " %s discard\t-->\tdiscard discard" lap0)
1297 (setcar lap0 'byte-discard)
1299 ((error "Optimizer error: too much on the stack"))))
1301 ;; goto*-X X: --> X:
1303 ((and (memq (car lap0) byte-goto-ops)
1304 (eq (cdr lap0) lap1))
1305 (cond ((eq (car lap0) 'byte-goto)
1306 (setq lap (delq lap0 lap))
1307 (setq tmp "<deleted>"))
1308 ((memq (car lap0) byte-goto-always-pop-ops)
1309 (setcar lap0 (setq tmp 'byte-discard))
1311 ((error "Depth conflict at tag %d" (nth 2 lap0))))
1312 (and (memq byte-optimize-log '(t byte))
1313 (byte-compile-log " (goto %s) %s:\t-->\t%s %s:"
1314 (nth 1 lap1) (nth 1 lap1)
1316 (setq keep-going t))
1318 ;; varset-X varref-X --> dup varset-X
1319 ;; varbind-X varref-X --> dup varbind-X
1320 ;; const/dup varset-X varref-X --> const/dup varset-X const/dup
1321 ;; const/dup varbind-X varref-X --> const/dup varbind-X const/dup
1322 ;; The latter two can enable other optimizations.
1324 ((and (eq 'byte-varref (car lap2))
1325 (eq (cdr lap1) (cdr lap2))
1326 (memq (car lap1) '(byte-varset byte-varbind)))
1327 (if (and (setq tmp (memq (car (cdr lap2)) byte-boolean-vars))
1328 (not (eq (car lap0) 'byte-constant)))
1331 (if (memq (car lap0) '(byte-constant byte-dup))
1333 (setq tmp (if (or (not tmp)
1334 (memq (car (cdr lap0)) '(nil t)))
1336 (byte-compile-get-constant t)))
1337 (byte-compile-log-lap " %s %s %s\t-->\t%s %s %s"
1338 lap0 lap1 lap2 lap0 lap1
1339 (cons (car lap0) tmp))
1340 (setcar lap2 (car lap0))
1342 (byte-compile-log-lap " %s %s\t-->\tdup %s" lap1 lap2 lap1)
1343 (setcar lap2 (car lap1))
1344 (setcar lap1 'byte-dup)
1346 ;; The stack depth gets locally increased, so we will
1347 ;; increase maxdepth in case depth = maxdepth here.
1348 ;; This can cause the third argument to byte-code to
1349 ;; be larger than necessary.
1350 (setq add-depth 1))))
1352 ;; dup varset-X discard --> varset-X
1353 ;; dup varbind-X discard --> varbind-X
1354 ;; (the varbind variant can emerge from other optimizations)
1356 ((and (eq 'byte-dup (car lap0))
1357 (eq 'byte-discard (car lap2))
1358 (memq (car lap1) '(byte-varset byte-varbind)))
1359 (byte-compile-log-lap " dup %s discard\t-->\t%s" lap1 lap1)
1362 (setq lap (delq lap0 (delq lap2 lap))))
1364 ;; not goto-X-if-nil --> goto-X-if-non-nil
1365 ;; not goto-X-if-non-nil --> goto-X-if-nil
1367 ;; it is wrong to do the same thing for the -else-pop variants.
1369 ((and (eq 'byte-not (car lap0))
1370 (or (eq 'byte-goto-if-nil (car lap1))
1371 (eq 'byte-goto-if-not-nil (car lap1))))
1372 (byte-compile-log-lap " not %s\t-->\t%s"
1375 (if (eq (car lap1) 'byte-goto-if-nil)
1376 'byte-goto-if-not-nil
1379 (setcar lap1 (if (eq (car lap1) 'byte-goto-if-nil)
1380 'byte-goto-if-not-nil
1382 (setq lap (delq lap0 lap))
1383 (setq keep-going t))
1385 ;; goto-X-if-nil goto-Y X: --> goto-Y-if-non-nil X:
1386 ;; goto-X-if-non-nil goto-Y X: --> goto-Y-if-nil X:
1388 ;; it is wrong to do the same thing for the -else-pop variants.
1390 ((and (or (eq 'byte-goto-if-nil (car lap0))
1391 (eq 'byte-goto-if-not-nil (car lap0))) ; gotoX
1392 (eq 'byte-goto (car lap1)) ; gotoY
1393 (eq (cdr lap0) lap2)) ; TAG X
1394 (let ((inverse (if (eq 'byte-goto-if-nil (car lap0))
1395 'byte-goto-if-not-nil 'byte-goto-if-nil)))
1396 (byte-compile-log-lap " %s %s %s:\t-->\t%s %s:"
1398 (cons inverse (cdr lap1)) lap2)
1399 (setq lap (delq lap0 lap))
1400 (setcar lap1 inverse)
1401 (setq keep-going t)))
1403 ;; const goto-if-* --> whatever
1405 ((and (eq 'byte-constant (car lap0))
1406 (memq (car lap1) byte-conditional-ops))
1407 (cond ((if (or (eq (car lap1) 'byte-goto-if-nil)
1408 (eq (car lap1) 'byte-goto-if-nil-else-pop))
1410 (not (car (cdr lap0))))
1411 (byte-compile-log-lap " %s %s\t-->\t<deleted>"
1413 (setq rest (cdr rest)
1414 lap (delq lap0 (delq lap1 lap))))
1416 (if (memq (car lap1) byte-goto-always-pop-ops)
1418 (byte-compile-log-lap " %s %s\t-->\t%s"
1419 lap0 lap1 (cons 'byte-goto (cdr lap1)))
1420 (setq lap (delq lap0 lap)))
1421 (byte-compile-log-lap " %s %s\t-->\t%s" lap0 lap1
1422 (cons 'byte-goto (cdr lap1))))
1423 (setcar lap1 'byte-goto)))
1424 (setq keep-going t))
1426 ;; varref-X varref-X --> varref-X dup
1427 ;; varref-X [dup ...] varref-X --> varref-X [dup ...] dup
1428 ;; We don't optimize the const-X variations on this here,
1429 ;; because that would inhibit some goto optimizations; we
1430 ;; optimize the const-X case after all other optimizations.
1432 ((and (eq 'byte-varref (car lap0))
1434 (setq tmp (cdr rest))
1435 (while (eq (car (car tmp)) 'byte-dup)
1436 (setq tmp (cdr tmp)))
1438 (eq (cdr lap0) (cdr (car tmp)))
1439 (eq 'byte-varref (car (car tmp))))
1440 (if (memq byte-optimize-log '(t byte))
1442 (setq tmp2 (cdr rest))
1443 (while (not (eq tmp tmp2))
1444 (setq tmp2 (cdr tmp2)
1445 str (concat str " dup")))
1446 (byte-compile-log-lap " %s%s %s\t-->\t%s%s dup"
1447 lap0 str lap0 lap0 str)))
1449 (setcar (car tmp) 'byte-dup)
1450 (setcdr (car tmp) 0)
1453 ;; TAG1: TAG2: --> TAG1: <deleted>
1454 ;; (and other references to TAG2 are replaced with TAG1)
1456 ((and (eq (car lap0) 'TAG)
1457 (eq (car lap1) 'TAG))
1458 (and (memq byte-optimize-log '(t byte))
1459 (byte-compile-log " adjacent tags %d and %d merged"
1460 (nth 1 lap1) (nth 1 lap0)))
1462 (while (setq tmp2 (rassq lap0 tmp3))
1464 (setq tmp3 (cdr (memq tmp2 tmp3))))
1465 (setq lap (delq lap0 lap)
1468 ;; unused-TAG: --> <deleted>
1470 ((and (eq 'TAG (car lap0))
1471 (not (rassq lap0 lap)))
1472 (and (memq byte-optimize-log '(t byte))
1473 (byte-compile-log " unused tag %d removed" (nth 1 lap0)))
1474 (setq lap (delq lap0 lap)
1477 ;; goto ... --> goto <delete until TAG or end>
1478 ;; return ... --> return <delete until TAG or end>
1480 ((and (memq (car lap0) '(byte-goto byte-return))
1481 (not (memq (car lap1) '(TAG nil))))
1484 (opt-p (memq byte-optimize-log '(t lap)))
1486 (while (and (setq tmp (cdr tmp))
1487 (not (eq 'TAG (car (car tmp)))))
1488 (if opt-p (setq deleted (cons (car tmp) deleted)
1489 str (concat str " %s")
1493 (if (eq 'TAG (car (car tmp)))
1494 (format "%d:" (cdr (car tmp)))
1495 (or (car tmp) ""))))
1497 (apply 'byte-compile-log-lap-1
1499 " %s\t-->\t%s <deleted> %s")
1501 (nconc (nreverse deleted)
1502 (list tagstr lap0 tagstr)))
1503 (byte-compile-log-lap
1504 " %s <%d unreachable op%s> %s\t-->\t%s <deleted> %s"
1505 lap0 i (if (= i 1) "" "s")
1506 tagstr lap0 tagstr))))
1508 (setq keep-going t))
1510 ;; <safe-op> unbind --> unbind <safe-op>
1511 ;; (this may enable other optimizations.)
1513 ((and (eq 'byte-unbind (car lap1))
1514 (memq (car lap0) byte-after-unbind-ops))
1515 (byte-compile-log-lap " %s %s\t-->\t%s %s" lap0 lap1 lap1 lap0)
1517 (setcar (cdr rest) lap0)
1518 (setq keep-going t))
1520 ;; varbind-X unbind-N --> discard unbind-(N-1)
1521 ;; save-excursion unbind-N --> unbind-(N-1)
1522 ;; save-restriction unbind-N --> unbind-(N-1)
1524 ((and (eq 'byte-unbind (car lap1))
1525 (memq (car lap0) '(byte-varbind byte-save-excursion
1526 byte-save-restriction))
1528 (if (zerop (setcdr lap1 (1- (cdr lap1))))
1530 (if (eq (car lap0) 'byte-varbind)
1531 (setcar rest (cons 'byte-discard 0))
1532 (setq lap (delq lap0 lap)))
1533 (byte-compile-log-lap " %s %s\t-->\t%s %s"
1534 lap0 (cons (car lap1) (1+ (cdr lap1)))
1535 (if (eq (car lap0) 'byte-varbind)
1538 (if (and (/= 0 (cdr lap1))
1539 (eq (car lap0) 'byte-varbind))
1542 (setq keep-going t))
1544 ;; goto*-X ... X: goto-Y --> goto*-Y
1545 ;; goto-X ... X: return --> return
1547 ((and (memq (car lap0) byte-goto-ops)
1548 (memq (car (setq tmp (nth 1 (memq (cdr lap0) lap))))
1549 '(byte-goto byte-return)))
1550 (cond ((and (not (eq tmp lap0))
1551 (or (eq (car lap0) 'byte-goto)
1552 (eq (car tmp) 'byte-goto)))
1553 (byte-compile-log-lap " %s [%s]\t-->\t%s"
1555 (if (eq (car tmp) 'byte-return)
1556 (setcar lap0 'byte-return))
1557 (setcdr lap0 (cdr tmp))
1558 (setq keep-going t))))
1560 ;; goto-*-else-pop X ... X: goto-if-* --> whatever
1561 ;; goto-*-else-pop X ... X: discard --> whatever
1563 ((and (memq (car lap0) '(byte-goto-if-nil-else-pop
1564 byte-goto-if-not-nil-else-pop))
1565 (memq (car (car (setq tmp (cdr (memq (cdr lap0) lap)))))
1567 (cons 'byte-discard byte-conditional-ops)))
1568 (not (eq lap0 (car tmp))))
1569 (setq tmp2 (car tmp))
1570 (setq tmp3 (assq (car lap0) '((byte-goto-if-nil-else-pop
1572 (byte-goto-if-not-nil-else-pop
1573 byte-goto-if-not-nil))))
1574 (if (memq (car tmp2) tmp3)
1575 (progn (setcar lap0 (car tmp2))
1576 (setcdr lap0 (cdr tmp2))
1577 (byte-compile-log-lap " %s-else-pop [%s]\t-->\t%s"
1578 (car lap0) tmp2 lap0))
1579 ;; Get rid of the -else-pop's and jump one step further.
1580 (or (eq 'TAG (car (nth 1 tmp)))
1581 (setcdr tmp (cons (byte-compile-make-tag)
1583 (byte-compile-log-lap " %s [%s]\t-->\t%s <skip>"
1584 (car lap0) tmp2 (nth 1 tmp3))
1585 (setcar lap0 (nth 1 tmp3))
1586 (setcdr lap0 (nth 1 tmp)))
1587 (setq keep-going t))
1589 ;; const goto-X ... X: goto-if-* --> whatever
1590 ;; const goto-X ... X: discard --> whatever
1592 ((and (eq (car lap0) 'byte-constant)
1593 (eq (car lap1) 'byte-goto)
1594 (memq (car (car (setq tmp (cdr (memq (cdr lap1) lap)))))
1596 (cons 'byte-discard byte-conditional-ops)))
1597 (not (eq lap1 (car tmp))))
1598 (setq tmp2 (car tmp))
1599 (cond ((memq (car tmp2)
1600 (if (null (car (cdr lap0)))
1601 '(byte-goto-if-nil byte-goto-if-nil-else-pop)
1602 '(byte-goto-if-not-nil
1603 byte-goto-if-not-nil-else-pop)))
1604 (byte-compile-log-lap " %s goto [%s]\t-->\t%s %s"
1605 lap0 tmp2 lap0 tmp2)
1606 (setcar lap1 (car tmp2))
1607 (setcdr lap1 (cdr tmp2))
1608 ;; Let next step fix the (const,goto-if*) sequence.
1609 (setq rest (cons nil rest)))
1611 ;; Jump one step further
1612 (byte-compile-log-lap
1613 " %s goto [%s]\t-->\t<deleted> goto <skip>"
1615 (or (eq 'TAG (car (nth 1 tmp)))
1616 (setcdr tmp (cons (byte-compile-make-tag)
1618 (setcdr lap1 (car (cdr tmp)))
1619 (setq lap (delq lap0 lap))))
1620 (setq keep-going t))
1622 ;; X: varref-Y ... varset-Y goto-X -->
1623 ;; X: varref-Y Z: ... dup varset-Y goto-Z
1624 ;; (varset-X goto-BACK, BACK: varref-X --> copy the varref down.)
1625 ;; (This is so usual for while loops that it is worth handling).
1627 ((and (eq (car lap1) 'byte-varset)
1628 (eq (car lap2) 'byte-goto)
1629 (not (memq (cdr lap2) rest)) ;Backwards jump
1630 (eq (car (car (setq tmp (cdr (memq (cdr lap2) lap)))))
1632 (eq (cdr (car tmp)) (cdr lap1))
1633 (not (memq (car (cdr lap1)) byte-boolean-vars)))
1634 ;;(byte-compile-log-lap " Pulled %s to end of loop" (car tmp))
1635 (let ((newtag (byte-compile-make-tag)))
1636 (byte-compile-log-lap
1637 " %s: %s ... %s %s\t-->\t%s: %s %s: ... %s %s %s"
1638 (nth 1 (cdr lap2)) (car tmp)
1640 (nth 1 (cdr lap2)) (car tmp)
1641 (nth 1 newtag) 'byte-dup lap1
1642 (cons 'byte-goto newtag)
1644 (setcdr rest (cons (cons 'byte-dup 0) (cdr rest)))
1645 (setcdr tmp (cons (setcdr lap2 newtag) (cdr tmp))))
1647 (setq keep-going t))
1649 ;; goto-X Y: ... X: goto-if*-Y --> goto-if-not-*-X+1 Y:
1650 ;; (This can pull the loop test to the end of the loop)
1652 ((and (eq (car lap0) 'byte-goto)
1653 (eq (car lap1) 'TAG)
1655 (cdr (car (setq tmp (cdr (memq (cdr lap0) lap))))))
1656 (memq (car (car tmp))
1657 '(byte-goto byte-goto-if-nil byte-goto-if-not-nil
1658 byte-goto-if-nil-else-pop)))
1659 ;; (byte-compile-log-lap " %s %s, %s %s --> moved conditional"
1660 ;; lap0 lap1 (cdr lap0) (car tmp))
1661 (let ((newtag (byte-compile-make-tag)))
1662 (byte-compile-log-lap
1663 "%s %s: ... %s: %s\t-->\t%s ... %s:"
1664 lap0 (nth 1 lap1) (nth 1 (cdr lap0)) (car tmp)
1665 (cons (cdr (assq (car (car tmp))
1666 '((byte-goto-if-nil . byte-goto-if-not-nil)
1667 (byte-goto-if-not-nil . byte-goto-if-nil)
1668 (byte-goto-if-nil-else-pop .
1669 byte-goto-if-not-nil-else-pop)
1670 (byte-goto-if-not-nil-else-pop .
1671 byte-goto-if-nil-else-pop))))
1676 (setcdr tmp (cons (setcdr lap0 newtag) (cdr tmp)))
1677 (if (eq (car (car tmp)) 'byte-goto-if-nil-else-pop)
1678 ;; We can handle this case but not the -if-not-nil case,
1679 ;; because we won't know which non-nil constant to push.
1680 (setcdr rest (cons (cons 'byte-constant
1681 (byte-compile-get-constant nil))
1683 (setcar lap0 (nth 1 (memq (car (car tmp))
1684 '(byte-goto-if-nil-else-pop
1685 byte-goto-if-not-nil
1687 byte-goto-if-not-nil
1688 byte-goto byte-goto))))
1690 (setq keep-going t))
1692 (setq rest (cdr rest)))
1695 ;; Rebuild byte-compile-constants / byte-compile-variables.
1696 ;; Simple optimizations that would inhibit other optimizations if they
1697 ;; were done in the optimizing loop, and optimizations which there is no
1698 ;; need to do more than once.
1699 (setq byte-compile-constants nil
1700 byte-compile-variables nil)
1703 (setq lap0 (car rest)
1705 (if (memq (car lap0) byte-constref-ops)
1706 (if (eq (cdr lap0) 'byte-constant)
1707 (or (memq (cdr lap0) byte-compile-variables)
1708 (setq byte-compile-variables (cons (cdr lap0)
1709 byte-compile-variables)))
1710 (or (memq (cdr lap0) byte-compile-constants)
1711 (setq byte-compile-constants (cons (cdr lap0)
1712 byte-compile-constants)))))
1714 ;; const-C varset-X const-C --> const-C dup varset-X
1715 ;; const-C varbind-X const-C --> const-C dup varbind-X
1717 (and (eq (car lap0) 'byte-constant)
1718 (eq (car (nth 2 rest)) 'byte-constant)
1719 (eq (cdr lap0) (car (nth 2 rest)))
1720 (memq (car lap1) '(byte-varbind byte-varset)))
1721 (byte-compile-log-lap " %s %s %s\t-->\t%s dup %s"
1722 lap0 lap1 lap0 lap0 lap1)
1723 (setcar (cdr (cdr rest)) (cons (car lap1) (cdr lap1)))
1724 (setcar (cdr rest) (cons 'byte-dup 0))
1727 ;; const-X [dup/const-X ...] --> const-X [dup ...] dup
1728 ;; varref-X [dup/varref-X ...] --> varref-X [dup ...] dup
1730 ((memq (car lap0) '(byte-constant byte-varref))
1734 (while (eq 'byte-dup (car (car (setq tmp (cdr tmp))))))
1735 (and (eq (cdr lap0) (cdr (car tmp)))
1736 (eq (car lap0) (car (car tmp)))))
1737 (setcar tmp (cons 'byte-dup 0))
1740 (byte-compile-log-lap
1741 " %s [dup/%s]... %s\t-->\t%s dup..." lap0 lap0 lap0)))
1743 ;; unbind-N unbind-M --> unbind-(N+M)
1745 ((and (eq 'byte-unbind (car lap0))
1746 (eq 'byte-unbind (car lap1)))
1747 (byte-compile-log-lap " %s %s\t-->\t%s" lap0 lap1
1749 (+ (cdr lap0) (cdr lap1))))
1751 (setq lap (delq lap0 lap))
1752 (setcdr lap1 (+ (cdr lap1) (cdr lap0))))
1754 (setq rest (cdr rest)))
1755 (setq byte-compile-maxdepth (+ byte-compile-maxdepth add-depth)))
1758 (provide 'byte-optimize)
1761 ;; To avoid "lisp nesting exceeds max-lisp-eval-depth" when this file compiles
1762 ;; itself, compile some of its most used recursive functions (at load time).
1765 (or (byte-code-function-p (symbol-function 'byte-optimize-form))
1766 (assq 'byte-code (symbol-function 'byte-optimize-form))
1767 (let ((byte-optimize nil)
1768 (byte-compile-warnings nil))
1769 (mapcar '(lambda (x)
1770 (or noninteractive (message "compiling %s..." x))
1772 (or noninteractive (message "compiling %s...done" x)))
1773 '(byte-optimize-form
1775 byte-optimize-predicate
1776 byte-optimize-binary-predicate
1777 ;; Inserted some more than necessary, to speed it up.
1778 byte-optimize-form-code-walker
1779 byte-optimize-lapcode))))
1782 ;;; byte-opt.el ends here