annotate lisp/cl-macs.el @ 5391:f9dc75bdbdc4

Implement #'load-time-value less hackishly, by modifying the byte compiler. 2011-04-02 Aidan Kehoe <kehoea@parhasard.net> * bytecomp.el (byte-compile-output-preface): New. * bytecomp.el (byte-compile-output-file-form): * bytecomp.el (byte-compile-output-docform): * bytecomp.el (byte-compile-file-form): * bytecomp.el (byte-compile-file-form-defmumble): * bytecomp.el (symbol-value): * bytecomp.el (byte-compile-symbol-value): New. * cl-macs.el (load-time-value): No longer implement load-time-value by very hackishly redefining #'byte-compile-file-form-defmumble, instead make the appropriate changes in #'byte-compile-file-form-defmumble and #'byte-compile-file-form instead. We also add a specific byte-compile method for #'symbol-value, using the add-properties-to-a-gensym approach that worked for #'block and #'return-from.
author Aidan Kehoe <kehoea@parhasard.net>
date Sat, 02 Apr 2011 16:13:20 +0100
parents 3889ef128488
children 97ac18bd1fa3 248176c74e6b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
613
023b83f4e54b [xemacs-hg @ 2001-06-10 10:42:16 by ben]
ben
parents: 452
diff changeset
1 ;;; cl-macs.el --- Common Lisp extensions for XEmacs Lisp (part four)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3 ;; Copyright (C) 1993, 2003, 2004 Free Software Foundation, Inc.
4906
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
4 ;; Copyright (C) 2002, 2010 Ben Wing.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
5
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
6 ;; Author: Dave Gillespie <daveg@synaptics.com>
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
7 ;; Version: 2.02
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
8 ;; Keywords: extensions
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
9
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
10 ;; This file is part of XEmacs.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
11
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
12 ;; XEmacs is free software; you can redistribute it and/or modify it
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
13 ;; under the terms of the GNU General Public License as published by
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
14 ;; the Free Software Foundation; either version 2, or (at your option)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
15 ;; any later version.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
16
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
17 ;; XEmacs is distributed in the hope that it will be useful, but
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
18 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
20 ;; General Public License for more details.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
21
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
22 ;; You should have received a copy of the GNU General Public License
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
23 ;; along with XEmacs; see the file COPYING. If not, write to the Free
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
24 ;; Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
25 ;; 02111-1307, USA.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
26
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
27 ;;; Synched up with: FSF 21.3.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
28
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
29 ;;; Commentary:
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
30
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
31 ;; These are extensions to Emacs Lisp that provide a degree of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
32 ;; Common Lisp compatibility, beyond what is already built-in
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
33 ;; in Emacs Lisp.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
34 ;;
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
35 ;; This package was written by Dave Gillespie; it is a complete
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
36 ;; rewrite of Cesar Quiroz's original cl.el package of December 1986.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
37 ;;
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
38 ;; Bug reports, comments, and suggestions are welcome!
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
39
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
40 ;; This file contains the portions of the Common Lisp extensions
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
41 ;; package which should be autoloaded, but need only be present
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
42 ;; if the compiler or interpreter is used---this file is not
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
43 ;; necessary for executing compiled code.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
44
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
45 ;; See cl.el for Change Log.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
46
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
47
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
48 ;;; Code:
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
49
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
50 (or (memq 'cl-19 features)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
51 (error "Tried to load `cl-macs' before `cl'!"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
52
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
53
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
54 (defmacro cl-pop2 (place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
55 (list 'prog1 (list 'car (list 'cdr place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
56 (list 'setq place (list 'cdr (list 'cdr place)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
57 (put 'cl-pop2 'edebug-form-spec 'edebug-sexps)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
58
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
59 (defvar cl-optimize-safety)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
60 (defvar cl-optimize-speed)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
61
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
62
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
63 ;;; This kludge allows macros which use cl-transform-function-property
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
64 ;;; to be called at compile-time.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
65
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
66 (require
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
67 (progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
68 (or (fboundp 'cl-transform-function-property)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
69 (defalias 'cl-transform-function-property
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
70 #'(lambda (n p f)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
71 (list 'put (list 'quote n) (list 'quote p)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
72 (list 'function (cons 'lambda f))))))
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
73 'xemacs))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
74
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
75
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
76 ;;; Initialization.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
77
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
78 (defvar cl-old-bc-file-form nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
79
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
80 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
81 (defun cl-compile-time-init ()
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
82 (run-hooks 'cl-hack-bytecomp-hook))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
83
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
84
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
85 ;;; Some predicates for analyzing Lisp forms. These are used by various
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
86 ;;; macro expanders to optimize the results in certain common cases.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
87
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
88 (defconst cl-simple-funcs '(car cdr nth aref elt if and or + - 1+ 1- min max
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
89 car-safe cdr-safe progn prog1 prog2))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
90 (defconst cl-safe-funcs '(* / % length memq list vector vectorp
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
91 < > <= >= = error))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
92
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
93 ;;; Check if no side effects, and executes quickly.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
94 (defun cl-simple-expr-p (x &optional size)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
95 (or size (setq size 10))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
96 (if (and (consp x) (not (memq (car x) '(quote function function*))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
97 (and (symbolp (car x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
98 (or (memq (car x) cl-simple-funcs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
99 (get (car x) 'side-effect-free))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
100 (progn
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
101 (setq size (1- size))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
102 (while (and (setq x (cdr x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
103 (setq size (cl-simple-expr-p (car x) size))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
104 (and (null x) (>= size 0) size)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
105 (and (> size 0) (1- size))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
106
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
107 (defun cl-simple-exprs-p (xs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
108 (while (and xs (cl-simple-expr-p (car xs)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
109 (setq xs (cdr xs)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
110 (not xs))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
111
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
112 ;;; Check if no side effects.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
113 (defun cl-safe-expr-p (x)
5316
9ac28212c75a #'cl-safe-expr-p, forms that start with the symbol lambda are also safe.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5314
diff changeset
114 (or (not (and (consp x) (not (memq (car x)
9ac28212c75a #'cl-safe-expr-p, forms that start with the symbol lambda are also safe.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5314
diff changeset
115 '(quote function function* lambda)))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
116 (and (symbolp (car x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
117 (or (memq (car x) cl-simple-funcs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
118 (memq (car x) cl-safe-funcs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
119 (get (car x) 'side-effect-free))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
120 (progn
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
121 (while (and (setq x (cdr x)) (cl-safe-expr-p (car x))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
122 (null x)))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
123
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
124 ;;; Check if constant (i.e., no side effects or dependencies).
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
125 (defun cl-const-expr-p (x)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
126 (cond ((consp x)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
127 (or (eq (car x) 'quote)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
128 (and (memq (car x) '(function function*))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
129 (or (symbolp (nth 1 x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
130 (and (eq (car-safe (nth 1 x)) 'lambda) 'func)))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
131 ((symbolp x) (and (memq x '(nil t)) t))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
132 (t t)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
133
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
134 (defun cl-const-exprs-p (xs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
135 (while (and xs (cl-const-expr-p (car xs)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
136 (setq xs (cdr xs)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
137 (not xs))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
138
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
139 (defun cl-const-expr-val (x &optional cl-not-constant)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
140 (let ((cl-const-expr-p (cl-const-expr-p x)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
141 (cond ((eq cl-const-expr-p t) (if (consp x) (nth 1 x) x))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
142 ((eq cl-const-expr-p 'func) (nth 1 x))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
143 (cl-not-constant))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
144
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
145 (defun cl-expr-access-order (x v)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
146 (if (cl-const-expr-p x) v
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
147 (if (consp x)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
148 (progn
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
149 (while (setq x (cdr x)) (setq v (cl-expr-access-order (car x) v)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
150 v)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
151 (if (eq x (car v)) (cdr v) '(t)))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
152
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
153 ;;; Count number of times X refers to Y. Return nil for 0 times.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
154 (defun cl-expr-contains (x y)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
155 (cond ((equal y x) 1)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
156 ((and (consp x) (not (memq (car-safe x) '(quote function function*))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
157 (let ((sum 0))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
158 (while x
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
159 (setq sum (+ sum (or (cl-expr-contains (pop x) y) 0))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
160 (and (> sum 0) sum)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
161 (t nil)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
162
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
163 (defun cl-expr-contains-any (x y)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
164 (while (and y (not (cl-expr-contains x (car y)))) (pop y))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
165 y)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
166
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
167 ;;; Check whether X may depend on any of the symbols in Y.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
168 (defun cl-expr-depends-p (x y)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
169 (and (not (cl-const-expr-p x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
170 (or (not (cl-safe-expr-p x)) (cl-expr-contains-any x y))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
171
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
172 ;;; Symbols.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
173
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
174 (defvar *gensym-counter*)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
175
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
176 ;; XEmacs change: gensym and gentemp have been moved to cl.el.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
177
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
178
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
179 ;;; Program structure.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
180
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
181 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
182 (defmacro defun* (name arglist &optional docstring &rest body)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
183 "Define NAME as a function.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
184 Like normal `defun', except ARGLIST allows full Common Lisp conventions,
872
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
185 and BODY is implicitly surrounded by (block NAME ...).
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
186
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
187 \"Full Common Lisp conventions\" means that:
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
188
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
189 -- In addition to &optional and &rest, the lambda-list keywords &key,
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
190 &allow-other-keys, and &aux are allowed.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
191
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
192 -- The format of the arguments to &optional is expanded: As well as simple
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
193 variables, they can be lists of the form (VAR [INITFORM [SVAR]]); when
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
194 no argument is available for VAR, INITFORM is evaluated (or nil, if
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
195 INITFORM is omitted) and stored as VAR's value, and SVAR is bound to t.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
196 If an arguent is available for VAR, and INITFORM is unused, SVAR is
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
197 bound to nil.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
198
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
199 -- &key specifies keyword arguments. The format of each argument is
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
200 VAR || ( { VAR || (KEYWORD VAR) } [INITFORM [SVAR]]).
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
201
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
202 If VAR is specified on its own, VAR is bound within BODY to the value
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
203 supplied by the caller for the corresponding keyword; for example, &key
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
204 my-value means callers write :my-value RUNTIME-EXPRESSION.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
205
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
206 If (VAR INITFORM) is specified, INITFORM is an expression evaluated at
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
207 runtime to determine a default value for VAR.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
208
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
209 If (VAR INITFORM SVAR) is specified, SVAR is variable available within
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
210 BODY that is non-nil if VAR was explicitly specified in the calling
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
211 expression.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
212
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
213 If ((KEYWORD VAR)) is specified, KEYWORD is the keyword to be used by
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
214 callers, and VAR is the corresponding variable binding within BODY.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
215
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
216 In calls to NAME, values for a given keyword may be supplied multiple
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
217 times. The first value is the only one used.
872
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
218
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
219 -- &allow-other-keys means that if other keyword arguments are given that are
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
220 not specifically list in the arg list, they are allowed, rather than an
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
221 error being signalled. They can be retrieved with an &rest form.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
222
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
223 -- &aux specifies extra bindings, exactly like a `let*' enclosing the body.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
224 The format of each binding is VAR || (VAR [INITFORM]) -- exactly like the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
225 format of `let'/`let*' bindings.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
226 "
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
227 (let* ((res (cl-transform-lambda (list* arglist docstring body) name))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
228 (form (list* 'defun name (cdr res))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
229 (if (car res) (list 'progn (car res) form) form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
230
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
231 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
232 (defmacro defmacro* (name arglist &optional docstring &rest body)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
233 "Define NAME as a macro.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
234 Like normal `defmacro', except ARGLIST allows full Common Lisp conventions,
872
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
235 and BODY is implicitly surrounded by (block NAME ...).
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
236
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
237 \"Full Common Lisp conventions\" means that:
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
238
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
239 -- The lambda-list keywords &optional, &rest, &key, &allow-other-keys, and
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
240 &aux are allowed, as in `defun*'.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
241
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
242 -- Three additional lambda-list keywords are allowed: &body, &whole, and
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
243 &environment:
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
244
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
245 &body is equivalent to &rest, but is intended to indicate that the
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
246 following arguments are the body of some piece of code, and should be
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
247 indented as such.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
248
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
249 &whole must come first; it is followed by a single variable that, at
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
250 macro expansion time, reflects all the arguments supplied to the macro,
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
251 as if it had been declared with a single &rest argument.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
252
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
253 &environment specifies local semantics for various macros for use within
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
254 the expansion of BODY. See the ENVIRONMENT argument to `macroexpand'.
872
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
255
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
256 -- The macro arg list syntax allows for \"destructuring\" -- see also
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
257 `destructuring-bind', which destructures exactly like `defmacro*', and
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
258 `loop', which does a rather different way of destructuring. Anywhere
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
259 that a simple argument may appear, and (if following a lambda-list
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
260 keyword) a list may not normally appear, an embedded lambda list can be
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
261 substituted. (The format of the embedded lambda list is exactly the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
262 same as for a top-level list except that &environment is not allowed.)
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
263 When matching this lambda list against a caller-specified argument, that
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
264 argument is treated as a list and normal lambda-list processing occurs,
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
265 just as if the entire operation were happening at top level.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
266 Furthermore, any lambda list, embedded or top-level, can be dotted at its
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
267 end, and this will cause matching with an appropriate dotted list given
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
268 as an argument.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
269
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
270 See `loop' for practical examples of destructuring, but
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
271 keep in mind that `loop' destructuring is somewhat different from macro
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
272 destructuring in that
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
273
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
274 (a) Macro destructuring has extra features in the various lambda-list
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
275 keywords, allowing for special processing of a list other than just
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
276 simple matching.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
277 (b) Macro destructuring is strict, in that an error is signalled if the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
278 actual structure does not match the expected structure. On the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
279 other hand, loop destructuring is lax -- extra arguments in a list
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
280 are ignored, not enough arguments cause the remaining parameters to
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
281 receive a value of nil, etc.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
282 "
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
283 (let* ((res (cl-transform-lambda (list* arglist docstring body) name))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
284 (form (list* 'defmacro name (cdr res))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
285 (if (car res) (list 'progn (car res) form) form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
286
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
287 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
288 (defmacro function* (symbol-or-lambda)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
289 "Introduce a function.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
290 Like normal `function', except that if argument is a lambda form, its
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
291 ARGLIST allows full Common Lisp conventions."
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
292 (if (eq (car-safe symbol-or-lambda) 'lambda)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
293 (let* ((res (cl-transform-lambda (cdr symbol-or-lambda) 'cl-none))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
294 (form (list 'function (cons 'lambda (cdr res)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
295 (if (car res) (list 'progn (car res) form) form))
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
296 (list 'function symbol-or-lambda)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
297
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
298 (defun cl-transform-function-property (func prop form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
299 (let ((res (cl-transform-lambda form func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
300 (append '(progn) (cdr (cdr (car res)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
301 (list (list 'put (list 'quote func) (list 'quote prop)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
302 (list 'function (cons 'lambda (cdr res))))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
303
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
304 (defconst lambda-list-keywords
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
305 '(&optional &rest &key &allow-other-keys &aux &whole &body &environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
306
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
307 (defvar cl-macro-environment nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
308 (defvar bind-block) (defvar bind-defs) (defvar bind-enquote)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
309 (defvar bind-inits) (defvar bind-lets) (defvar bind-forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
310
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
311 ;; npak@ispras.ru
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
312 (defun cl-upcase-arg (arg)
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
313 ;; Changes all non-keyword symbols in `ARG' to symbols
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
314 ;; with name in upper case.
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
315 ;; ARG is either symbol or list of symbols or lists
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
316 (cond ((symbolp arg)
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
317 ;; Do not upcase &optional, &key etc.
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
318 (if (memq arg lambda-list-keywords)
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
319 arg
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
320 (make-symbol (upcase (symbol-name arg)))))
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
321 ((listp arg)
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
322 (let ((arg (copy-list arg)) junk)
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
323 ;; Clean the list
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
324 (let ((p (last arg))) (if (cdr p) (setcdr p (list '&rest (cdr p)))))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
325 (if (setq junk (cadr (memq '&cl-defs arg)))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
326 (setq arg (delq '&cl-defs (delq junk arg))))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
327 (if (memq '&cl-quote arg)
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
328 (setq arg (delq '&cl-quote arg)))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
329 (mapcar 'cl-upcase-arg arg)))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
330 (t arg))) ; Maybe we are in initializer
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
331
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
332 ;; npak@ispras.ru, modified by ben@666.com
4702
eb1a409c317b Unbreak autoload.el
Mike Sperber <sperber@deinprogramm.de>
parents: 4695
diff changeset
333 ;;;###autoload
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
334 (defun cl-function-arglist (arglist)
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
335 "Returns string with printed representation of arguments list.
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
336 Supports Common Lisp lambda lists."
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
337 (if (not (or (listp arglist) (symbolp arglist)))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
338 "Not available"
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
339 (check-argument-type #'true-list-p arglist)
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
340 (let ((print-gensym nil))
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
341 (condition-case nil
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
342 (let ((args (cond ((null arglist) nil)
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
343 ((listp arglist) (cl-upcase-arg arglist))
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
344 ((symbolp arglist)
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
345 (cl-upcase-arg (list '&rest arglist)))
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
346 (t (wrong-type-argument 'listp arglist)))))
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
347 (if args (prin1-to-string args) "()"))
5070
b0f4adffca7d fix so that CL docstrings (with &key, etc.) handled properly
Ben Wing <ben@xemacs.org>
parents: 4997
diff changeset
348 (t "Not available")))))
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
349
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
350 (defun cl-transform-lambda (form bind-block)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
351 (let* ((args (car form)) (body (cdr form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
352 (bind-defs nil) (bind-enquote nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
353 (bind-inits nil) (bind-lets nil) (bind-forms nil)
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
354 (header nil) (simple-args nil)
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
355 (complex-arglist (cl-function-arglist args))
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
356 (doc ""))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
357 (while (or (stringp (car body)) (eq (car-safe (car body)) 'interactive))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
358 (push (pop body) header))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
359 (setq args (if (listp args) (copy-list args) (list '&rest args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
360 (let ((p (last args))) (if (cdr p) (setcdr p (list '&rest (cdr p)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
361 (if (setq bind-defs (cadr (memq '&cl-defs args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
362 (setq args (delq '&cl-defs (delq bind-defs args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
363 bind-defs (cadr bind-defs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
364 (if (setq bind-enquote (memq '&cl-quote args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
365 (setq args (delq '&cl-quote args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
366 (if (memq '&whole args) (error "&whole not currently implemented"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
367 (let* ((p (memq '&environment args)) (v (cadr p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
368 (if p (setq args (nconc (delq (car p) (delq v args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
369 (list '&aux (list v 'cl-macro-environment))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
370 (while (and args (symbolp (car args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
371 (not (memq (car args) '(nil &rest &body &key &aux)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
372 (not (and (eq (car args) '&optional)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
373 (or bind-defs (consp (cadr args))))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
374 (push (pop args) simple-args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
375 (or (eq bind-block 'cl-none)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
376 (setq body (list (list* 'block bind-block body))))
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
377 (setq simple-args (nreverse simple-args)
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
378 header (nreverse header))
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
379 ;; Add CL lambda list to documentation, if the CL lambda list differs
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
380 ;; from the non-CL lambda list. npak@ispras.ru
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
381 (unless (equal complex-arglist
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
382 (cl-function-arglist simple-args))
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
383 (and (stringp (car header)) (setq doc (pop header)))
5070
b0f4adffca7d fix so that CL docstrings (with &key, etc.) handled properly
Ben Wing <ben@xemacs.org>
parents: 4997
diff changeset
384 ;; Stick the arguments onto the end of the doc string in a way that
b0f4adffca7d fix so that CL docstrings (with &key, etc.) handled properly
Ben Wing <ben@xemacs.org>
parents: 4997
diff changeset
385 ;; will be recognized specially by `function-arglist'.
b0f4adffca7d fix so that CL docstrings (with &key, etc.) handled properly
Ben Wing <ben@xemacs.org>
parents: 4997
diff changeset
386 (push (concat doc "\n\narguments: " complex-arglist "\n")
b0f4adffca7d fix so that CL docstrings (with &key, etc.) handled properly
Ben Wing <ben@xemacs.org>
parents: 4997
diff changeset
387 header))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
388 (if (null args)
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
389 (list* nil simple-args (nconc header body))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
390 (if (memq '&optional simple-args) (push '&optional args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
391 (cl-do-arglist args nil (- (length simple-args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
392 (if (memq '&optional simple-args) 1 0)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
393 (setq bind-lets (nreverse bind-lets))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
394 (list* (and bind-inits (list* 'eval-when '(compile load eval)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
395 (nreverse bind-inits)))
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
396 (nconc simple-args
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
397 (list '&rest (car (pop bind-lets))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
398 ;; XEmacs change: we add usage information using Nickolay's
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
399 ;; approach above
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
400 (nconc header
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
401 (list (nconc (list 'let* bind-lets)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
402 (nreverse bind-forms) body)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
403
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
404 (defun cl-do-arglist (args expr &optional num) ; uses bind-*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
405 (if (nlistp args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
406 (if (or (memq args lambda-list-keywords) (not (symbolp args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
407 (error "Invalid argument name: %s" args)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
408 (push (list args expr) bind-lets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
409 (setq args (copy-list args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
410 (let ((p (last args))) (if (cdr p) (setcdr p (list '&rest (cdr p)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
411 (let ((p (memq '&body args))) (if p (setcar p '&rest)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
412 (if (memq '&environment args) (error "&environment used incorrectly"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
413 (let ((save-args args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
414 (restarg (memq '&rest args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
415 (safety (if (cl-compiling-file) cl-optimize-safety 3))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
416 (keys nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
417 (laterarg nil) (exactarg nil) minarg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
418 (or num (setq num 0))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
419 (if (listp (cadr restarg))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
420 (setq restarg (gensym "--rest--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
421 (setq restarg (cadr restarg)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
422 (push (list restarg expr) bind-lets)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
423 (if (eq (car args) '&whole)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
424 (push (list (cl-pop2 args) restarg) bind-lets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
425 (let ((p args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
426 (setq minarg restarg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
427 (while (and p (not (memq (car p) lambda-list-keywords)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
428 (or (eq p args) (setq minarg (list 'cdr minarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
429 (setq p (cdr p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
430 (if (memq (car p) '(nil &aux))
5366
f00192e1cd49 Examining the result of #'length: `eql', not `=', it's better style & cheaper
Aidan Kehoe <kehoea@parhasard.net>
parents: 5356
diff changeset
431 (setq minarg (list 'eql (list 'length restarg)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
432 (length (ldiff args p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
433 exactarg (not (eq args p)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
434 (while (and args (not (memq (car args) lambda-list-keywords)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
435 (let ((poparg (list (if (or (cdr args) (not exactarg)) 'pop 'car)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
436 restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
437 (cl-do-arglist
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
438 (pop args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
439 (if (or laterarg (= safety 0)) poparg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
440 (list 'if minarg poparg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
441 (list 'signal '(quote wrong-number-of-arguments)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
442 (list 'list (and (not (eq bind-block 'cl-none))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
443 (list 'quote bind-block))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
444 (list 'length restarg)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
445 (setq num (1+ num) laterarg t))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
446 (while (and (eq (car args) '&optional) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
447 (while (and args (not (memq (car args) lambda-list-keywords)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
448 (let ((arg (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
449 (or (consp arg) (setq arg (list arg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
450 (if (cddr arg) (cl-do-arglist (nth 2 arg) (list 'and restarg t)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
451 (let ((def (if (cdr arg) (nth 1 arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
452 (or (car bind-defs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
453 (nth 1 (assq (car arg) bind-defs)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
454 (poparg (list 'pop restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
455 (and def bind-enquote (setq def (list 'quote def)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
456 (cl-do-arglist (car arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
457 (if def (list 'if restarg poparg def) poparg))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
458 (setq num (1+ num))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
459 (if (eq (car args) '&rest)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
460 (let ((arg (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
461 (if (consp arg) (cl-do-arglist arg restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
462 (or (eq (car args) '&key) (= safety 0) exactarg
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
463 (push (list 'if restarg
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
464 (list 'signal '(quote wrong-number-of-arguments)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
465 (list 'list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
466 (and (not (eq bind-block 'cl-none))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
467 (list 'quote bind-block))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
468 (list '+ num (list 'length restarg)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
469 bind-forms)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
470 (while (and (eq (car args) '&key) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
471 (while (and args (not (memq (car args) lambda-list-keywords)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
472 (let ((arg (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
473 (or (consp arg) (setq arg (list arg)))
4793
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
474 (let* ((karg (if (consp (car arg))
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
475 ;; It's possible to use non-keywords here, as
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
476 ;; in the KEYWORD-ARGUMENT-NAME-PACKAGE Common
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
477 ;; Lisp issue:
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
478 (caar arg)
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
479 ;; Use read instead of intern in case we ever
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
480 ;; actually get packages and keywords are no
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
481 ;; longer in obarray:
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
482 (read (concat ":" (symbol-name (car arg))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
483 (varg (if (consp (car arg)) (cadar arg) (car arg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
484 (def (if (cdr arg) (cadr arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
485 (or (car bind-defs) (cadr (assq varg bind-defs)))))
4793
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
486 (look (list 'memq (quote-maybe karg) restarg)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
487 (and def bind-enquote (setq def (list 'quote def)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
488 (if (cddr arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
489 (let* ((temp (or (nth 2 arg) (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
490 (val (list 'car (list 'cdr temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
491 (cl-do-arglist temp look)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
492 (cl-do-arglist varg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
493 (list 'if temp
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
494 (list 'prog1 val (list 'setq temp t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
495 def)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
496 (cl-do-arglist
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
497 varg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
498 (list 'car
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
499 (list 'cdr
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
500 (if (null def)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
501 look
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
502 (list 'or look
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
503 (if (eq (cl-const-expr-p def) t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
504 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
505 'quote
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
506 (list nil (cl-const-expr-val def)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
507 (list 'list nil def))))))))
4793
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
508 (push karg keys)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
509 (setq keys (nreverse keys))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
510 (or (and (eq (car args) '&allow-other-keys) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
511 (null keys) (= safety 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
512 (let* ((var (gensym "--keys--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
513 (allow '(:allow-other-keys))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
514 (check (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
515 'while var
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
516 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
517 'cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
518 (list (list 'memq (list 'car var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
519 (list 'quote (append keys allow)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
520 (list 'setq var (list 'cdr (list 'cdr var))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
521 (list (list 'car
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
522 (list 'cdr
4793
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
523 (list 'memq (car allow)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
524 restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
525 (list 'setq var nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
526 (list t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
527 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
528 'error
5084
6afe991b8135 Add a PARSE_KEYWORDS macro, use it in #'make-hash-table.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5080
diff changeset
529 ''invalid-keyword-argument
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
530 (list 'car var)))))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
531 (push (list 'let (list (list var restarg)) check) bind-forms)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
532 (while (and (eq (car args) '&aux) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
533 (while (and args (not (memq (car args) lambda-list-keywords)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
534 (if (consp (car args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
535 (if (and bind-enquote (cadar args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
536 (cl-do-arglist (caar args)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
537 (list 'quote (cadr (pop args))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
538 (cl-do-arglist (caar args) (cadr (pop args))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
539 (cl-do-arglist (pop args) nil))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
540 (if args (error "Malformed argument list %s" save-args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
541
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
542 (defun cl-arglist-args (args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
543 (if (nlistp args) (list args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
544 (let ((res nil) (kind nil) arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
545 (while (consp args)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
546 (setq arg (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
547 (if (memq arg lambda-list-keywords) (setq kind arg)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
548 (if (eq arg '&cl-defs) (pop args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
549 (and (consp arg) kind (setq arg (car arg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
550 (and (consp arg) (cdr arg) (eq kind '&key) (setq arg (cadr arg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
551 (setq res (nconc res (cl-arglist-args arg))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
552 (nconc res (and args (list args))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
553
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
554 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
555 (defmacro destructuring-bind (args expr &rest body)
872
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
556 "Bind the arguments in ARGS to EXPR then eval BODY.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
557 This is similar to `let' but it does \"destructuring\", in that it matches
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
558 the structure of ARGS to the structure of EXPR and binds corresponding
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
559 arguments in ARGS to their values in EXPR. The format of ARGS, and the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
560 way the destructuring works, is exactly like the destructuring that occurs
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
561 in `defmacro*'; see that for more information.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
562
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
563 An alternative means of destructuring is using the `loop' macro. `loop'
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
564 gives practical examples of destructuring. `defmacro*' describes the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
565 differences between loop and macro-style destructuring.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
566
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
567 You can rewrite a call to (destructuring-bind ARGS EXPR &rest BODY) using
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
568 `loop', approximately like this:
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
569
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
570 (loop for ARGS = EXPR
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
571 return (progn BODY))
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
572
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
573 I say \"approximately\" because the destructuring works in a somewhat
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
574 different fashion, although for most reasonably simple constructs the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
575 results will be the same."
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
576 (let* ((bind-lets nil) (bind-forms nil) (bind-inits nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
577 (bind-defs nil) (bind-block 'cl-none))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
578 (cl-do-arglist (or args '(&aux)) expr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
579 (append '(progn) bind-inits
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
580 (list (nconc (list 'let* (nreverse bind-lets))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
581 (nreverse bind-forms) body)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
582
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
583
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
584 ;;; The `eval-when' form.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
585
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
586 (defvar cl-not-toplevel nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
587
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
588 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
589 (defmacro eval-when (when &rest body)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
590 "Control when BODY is evaluated.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
591 If `compile' is in WHEN, BODY is evaluated when compiled at top-level.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
592 If `load' is in WHEN, BODY is evaluated when loaded after top-level compile.
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
593 If `eval' is in WHEN, BODY is evaluated when interpreted or at non-top-level.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
594
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
595 arguments: ((&rest WHEN) &body BODY)"
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
596 (if (and (fboundp 'cl-compiling-file) (cl-compiling-file)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
597 (not cl-not-toplevel) (not (boundp 'for-effect))) ; horrible kludge
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
598 (let ((comp (or (memq 'compile when) (memq :compile-toplevel when)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
599 (cl-not-toplevel t))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
600 (if (or (memq 'load when) (memq :load-toplevel when))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
601 (if comp (cons 'progn (mapcar 'cl-compile-time-too body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
602 (list* 'if nil nil body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
603 (progn (if comp (eval (cons 'progn body))) nil)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
604 (and (or (memq 'eval when) (memq :execute when))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
605 (cons 'progn body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
606
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
607 (defun cl-compile-time-too (form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
608 (or (and (symbolp (car-safe form)) (get (car-safe form) 'byte-hunk-handler))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
609 (setq form (macroexpand
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
610 form (cons '(eval-when) byte-compile-macro-environment))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
611 (cond ((eq (car-safe form) 'progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
612 (cons 'progn (mapcar 'cl-compile-time-too (cdr form))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
613 ((eq (car-safe form) 'eval-when)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
614 (let ((when (nth 1 form)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
615 (if (or (memq 'eval when) (memq :execute when))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
616 (list* 'eval-when (cons 'compile when) (cddr form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
617 form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
618 (t (eval form) form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
619
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
620 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
621 (defmacro load-time-value (form &optional read-only)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
622 "Like `progn', but evaluates the body at load time.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
623 The result of the body appears to the compiler as a quoted constant."
5391
f9dc75bdbdc4 Implement #'load-time-value less hackishly, by modifying the byte compiler.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5384
diff changeset
624 (let ((gensym (gensym)))
f9dc75bdbdc4 Implement #'load-time-value less hackishly, by modifying the byte compiler.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5384
diff changeset
625 ;; The body of this macro really should be (cons 'progn form), with the
f9dc75bdbdc4 Implement #'load-time-value less hackishly, by modifying the byte compiler.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5384
diff changeset
626 ;; hairier stuff in a shadowed version in
f9dc75bdbdc4 Implement #'load-time-value less hackishly, by modifying the byte compiler.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5384
diff changeset
627 ;; byte-compile-initial-macro-environment. That doesn't work because
f9dc75bdbdc4 Implement #'load-time-value less hackishly, by modifying the byte compiler.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5384
diff changeset
628 ;; cl-macs.el doesn't respect byte-compile-macro-environment, which is
f9dc75bdbdc4 Implement #'load-time-value less hackishly, by modifying the byte compiler.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5384
diff changeset
629 ;; something we should change.
f9dc75bdbdc4 Implement #'load-time-value less hackishly, by modifying the byte compiler.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5384
diff changeset
630 (put gensym 'cl-load-time-value-form form)
f9dc75bdbdc4 Implement #'load-time-value less hackishly, by modifying the byte compiler.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5384
diff changeset
631 (set gensym (eval form))
f9dc75bdbdc4 Implement #'load-time-value less hackishly, by modifying the byte compiler.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5384
diff changeset
632 `(symbol-value ',gensym)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
633
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
634 ;;; Conditional control structures.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
635
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
636 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
637 (defmacro case (expr &rest clauses)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
638 "Evals EXPR, chooses from CLAUSES on that value.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
639 Each clause looks like (KEYLIST BODY...). EXPR is evaluated and compared
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
640 against each key in each KEYLIST; the corresponding BODY is evaluated.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
641 If no clause succeeds, case returns nil. A single atom may be used in
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
642 place of a KEYLIST of one atom. A KEYLIST of `t' or `otherwise' is
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
643 allowed only in the final clause, and matches if no other keys match.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
644 Key values are compared by `eql'."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
645 (let* ((temp (if (cl-simple-expr-p expr 3) expr (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
646 (head-list nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
647 (last-clause (car (last clauses)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
648 (body (cons
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
649 'cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
650 (mapcar
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
651 #'(lambda (c)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
652 (cons (cond ((memq (car c) '(t otherwise))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
653 ;; XEmacs addition: check for last clause
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
654 (or (eq c last-clause)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
655 (error
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
656 "`%s' is allowed only as the last case clause"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
657 (car c)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
658 t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
659 ((eq (car c) 'ecase-error-flag)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
660 (list 'error "ecase failed: %s, %s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
661 temp (list 'quote (reverse head-list))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
662 ((listp (car c))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
663 (setq head-list (append (car c) head-list))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
664 (list 'member* temp (list 'quote (car c))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
665 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
666 (if (memq (car c) head-list)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
667 (error "Duplicate key in case: %s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
668 (car c)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
669 (push (car c) head-list)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
670 (list 'eql temp (list 'quote (car c)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
671 (or (cdr c) '(nil))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
672 clauses))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
673 (if (eq temp expr) body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
674 (list 'let (list (list temp expr)) body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
675
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
676 ;; #### CL standard also requires `ccase', which signals a continuable
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
677 ;; error (`cerror' in XEmacs). However, I don't think it buys us
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
678 ;; anything to introduce it, as there is probably much more CL stuff
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
679 ;; missing, and the feature is not essential. --hniksic
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
680
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
681 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
682 (defmacro ecase (expr &rest clauses)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
683 "Like `case', but error if no case fits.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
684 `otherwise'-clauses are not allowed."
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
685 ;; XEmacs addition: disallow t and otherwise
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
686 (let ((disallowed (or (assq t clauses)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
687 (assq 'otherwise clauses))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
688 (if disallowed
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
689 (error "`%s' is not allowed in ecase" (car disallowed))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
690 (list* 'case expr (append clauses '((ecase-error-flag)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
691
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
692 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
693 (defmacro typecase (expr &rest clauses)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
694 "Evals EXPR, chooses from CLAUSES on that value.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
695 Each clause looks like (TYPE BODY...). EXPR is evaluated and, if it
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
696 satisfies TYPE, the corresponding BODY is evaluated. If no clause succeeds,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
697 typecase returns nil. A TYPE of `t' or `otherwise' is allowed only in the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
698 final clause, and matches if no other keys match."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
699 (let* ((temp (if (cl-simple-expr-p expr 3) expr (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
700 (type-list nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
701 (body (cons
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
702 'cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
703 (mapcar
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
704 #'(lambda (c)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
705 (cons (cond ((eq (car c) 'otherwise) t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
706 ((eq (car c) 'ecase-error-flag)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
707 (list 'error "etypecase failed: %s, %s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
708 temp (list 'quote (reverse type-list))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
709 (t
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
710 (push (car c) type-list)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
711 (cl-make-type-test temp (car c))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
712 (or (cdr c) '(nil))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
713 clauses))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
714 (if (eq temp expr) body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
715 (list 'let (list (list temp expr)) body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
716
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
717 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
718 (defmacro etypecase (expr &rest clauses)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
719 "Like `typecase', but error if no case fits.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
720 `otherwise'-clauses are not allowed."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
721 (list* 'typecase expr (append clauses '((ecase-error-flag)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
722
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
723
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
724 ;;; Blocks and exits.
5353
38e24b8be4ea Improve the lexical scoping in #'block, #'return-from.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5346
diff changeset
725 (defvar cl-active-block-names nil)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
726
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
727 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
728 (defmacro block (name &rest body)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
729 "Define a lexically-scoped block named NAME.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
730 NAME may be any symbol. Code inside the BODY forms can call `return-from'
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
731 to jump prematurely out of the block. This differs from `catch' and `throw'
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
732 in two respects: First, the NAME is an unevaluated symbol rather than a
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
733 quoted symbol or other form; and second, NAME is lexically rather than
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
734 dynamically scoped: Only references to it within BODY will work. These
5353
38e24b8be4ea Improve the lexical scoping in #'block, #'return-from.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5346
diff changeset
735 references may appear inside macro expansions and in lambda expressions, but
38e24b8be4ea Improve the lexical scoping in #'block, #'return-from.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5346
diff changeset
736 not inside other functions called from BODY."
38e24b8be4ea Improve the lexical scoping in #'block, #'return-from.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5346
diff changeset
737 (let ((cl-active-block-names (acons name (copy-symbol name)
38e24b8be4ea Improve the lexical scoping in #'block, #'return-from.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5346
diff changeset
738 cl-active-block-names))
38e24b8be4ea Improve the lexical scoping in #'block, #'return-from.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5346
diff changeset
739 (body (cons 'progn body)))
5356
5dd1ba5e0113 Be better about eliminating `block's that are not `return-from'd, bytecomp.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5353
diff changeset
740 ;; Tell the byte-compiler this is a block, not a normal catch call, and
5dd1ba5e0113 Be better about eliminating `block's that are not `return-from'd, bytecomp.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5353
diff changeset
741 ;; as such it can eliminate it if that's appropriate:
5dd1ba5e0113 Be better about eliminating `block's that are not `return-from'd, bytecomp.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5353
diff changeset
742 (put (cdar cl-active-block-names) 'cl-block-name name)
5353
38e24b8be4ea Improve the lexical scoping in #'block, #'return-from.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5346
diff changeset
743 `(catch ',(cdar cl-active-block-names)
38e24b8be4ea Improve the lexical scoping in #'block, #'return-from.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5346
diff changeset
744 ,(cl-macroexpand-all body cl-macro-environment))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
745
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
746 ;;;###autoload
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
747 (defmacro return (&optional result)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
748 "Return from the block named nil.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
749 This is equivalent to `(return-from nil RESULT)'."
5353
38e24b8be4ea Improve the lexical scoping in #'block, #'return-from.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5346
diff changeset
750 `(return-from nil ,result))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
751
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
752 ;;;###autoload
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
753 (defmacro return-from (name &optional result)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
754 "Return from the block named NAME.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
755 This jumps out to the innermost enclosing `(block NAME ...)' form,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
756 returning RESULT from that form (or nil if RESULT is omitted).
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
757 This is compatible with Common Lisp, but note that `defun' and
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
758 `defmacro' do not create implicit blocks as they do in Common Lisp."
5356
5dd1ba5e0113 Be better about eliminating `block's that are not `return-from'd, bytecomp.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5353
diff changeset
759 `(throw ',(or (cdr (assq name cl-active-block-names))
5376
4b529b940e2e Eliminate unused blocks named nil, too, cl-macs.el, bytecomp.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5367
diff changeset
760 ;; Tell the byte-compiler the original name of the block,
4b529b940e2e Eliminate unused blocks named nil, too, cl-macs.el, bytecomp.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5367
diff changeset
761 ;; leave any warning to it.
4b529b940e2e Eliminate unused blocks named nil, too, cl-macs.el, bytecomp.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5367
diff changeset
762 (let ((copy-symbol (copy-symbol name)))
4b529b940e2e Eliminate unused blocks named nil, too, cl-macs.el, bytecomp.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5367
diff changeset
763 (put copy-symbol 'cl-block-name name)
4b529b940e2e Eliminate unused blocks named nil, too, cl-macs.el, bytecomp.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5367
diff changeset
764 copy-symbol))
4b529b940e2e Eliminate unused blocks named nil, too, cl-macs.el, bytecomp.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5367
diff changeset
765 ,result))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
766
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
767 ;;; The "loop" macro.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
768
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
769 (defvar args) (defvar loop-accum-var) (defvar loop-accum-vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
770 (defvar loop-bindings) (defvar loop-body) (defvar loop-destr-temps)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
771 (defvar loop-finally) (defvar loop-finish-flag) (defvar loop-first-flag)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
772 (defvar loop-initially) (defvar loop-map-form) (defvar loop-name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
773 (defvar loop-result) (defvar loop-result-explicit)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
774 (defvar loop-result-var) (defvar loop-steps) (defvar loop-symbol-macs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
775
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
776 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
777 (defmacro loop (&rest clauses)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
778 "The Common Lisp `loop' macro.
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
779
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
780 The loop macro consists of a series of clauses, which do things like
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
781 iterate variables, set conditions for exiting the loop, accumulating values
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
782 to be returned as the return value of the loop, and executing arbitrary
2297
13a418960a88 [xemacs-hg @ 2004-09-22 02:05:42 by stephent]
stephent
parents: 2153
diff changeset
783 blocks of code. Each clause is processed in turn, and the loop executes its
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
784 body repeatedly until an exit condition is hit.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
785
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
786 It's important to understand that loop clauses such as `for' and `while',
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
787 which look like loop-establishing constructs, don't actually *establish* a
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
788 loop\; the looping is established by the `loop' clause itself, which will
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
789 repeatedly process its body until told to stop. `while' merely establishes
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
790 a condition which, when true, causes the loop to finish, and `for' sets a
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
791 variable to different values on each iteration (e.g. successive elements of
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
792 a list) and sets an exit condition when there are no more values. This
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
793 means, for example, that if two `for' clauses appear, you don't get two
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
794 nested loops, but instead two variables that are stepped in parallel, and
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
795 two exit conditions, either of which, if triggered, will cause the loop to
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
796 end. Similarly for a loop with a `for' and a `while' clause. For example:
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
797
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
798 \(loop
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
799 for x in list
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
800 while x
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
801 do ...)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
802
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
803 In each successive iteration, X is set to the next element of the list. If
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
804 there are no more elements, or if any element is nil (the `while' clause),
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
805 the loop exits. Otherwise, the block of code following `do' is executed.)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
806
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
807 This example also shows that some clauses establish variable bindings --
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
808 essentially like a `let' binding -- and that following clauses can
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
809 reference these variables. Furthermore, the entire loop is surrounded by a
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
810 block named nil (unless the `named' clause is given), so you can return
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
811 from the loop using the macro `return'. (The other way to exit the loop is
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
812 through the macro `loop-finish'. The difference is that some loop clauses
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
813 establish or accumulate a value to be returned, and `loop-finish' returns
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
814 this. `return', however, can only return an explicitly-specified value.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
815 NOTE CAREFULLY: There is a loop clause called `return' as well as a
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
816 standard Lisp macro called `return'. Normally they work similarly\; but if
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
817 you give the loop a name with `named', you will need to use the macro
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
818 `return-from'.)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
819
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
820 Another extremely useful feature of loops is called \"destructuring\". If,
5384
3889ef128488 Fix misspelled words, and some grammar, across the entire source tree.
Jerry James <james@xemacs.org>
parents: 5380
diff changeset
821 in place of VAR, a list (possibly dotted, possibly a tree of arbitrary
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
822 complexity) is given, the value to be assigned is assumed to have a similar
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
823 structure to the list given, and variables in the list will be matched up
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
824 with corresponding elements in the structure. For example:
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
825
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
826 \(loop
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
827 for (x y) in '((foo 1) (bar 2) (baz 3))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
828 do (puthash x y some-hash-table))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
829
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
830 will add three elements to a hash table, mapping foo -> 1, bar -> 2, and
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
831 baz -> 3. As other examples, you can conveniently process alists using
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
832
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
833 \(loop for (x . y) in alist do ...)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
834
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
835 and plists using
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
836
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
837 \(loop for (x y) on plist by #'cddr do ...)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
838
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
839 Destructuring is forgiving in that mismatches in the number of elements on
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
840 either size will be handled gracefully, either by ignoring or initializing
1123
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
841 to nil. Destructuring is extremely powerful, and is probably the single
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
842 most useful feature of `loop'.
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
843
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
844 Other useful features of loops are iterating over hash-tables, collecting values into lists, and being able to modify lists in-place as you iterate over them. As an example of the first two,
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
845
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
846 \(loop for x being the hash-key in table using (hash-value y)
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
847 collect (cons x y))
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
848
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
849 converts hash-table TABLE to an alist. (What `collect' actually does is
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
850 push its value onto the end of an internal list and establish this list as
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
851 the default return value of the loop. See below for more information.)
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
852
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
853 An example of in-place modification is
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
854
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
855 \(setq foo '(1 3 5))
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
856 \(loop for x in-ref foo do
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
857 (setf x (* x x)))
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
858
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
859 after which foo will contain '(1 9 25).
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
860
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
861 If you don't understand how a particular loop clause works, create an
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
862 example and use `macroexpand-sexp' to expand the macro.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
863
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
864 Valid clauses are:
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
865
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
866 \(NOTE: Keywords in lowercase\; slashes separate different possibilities
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
867 for keywords, some of which are synonymous\; brackets indicate optional
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
868 parts of the clause. In all of the clauses with `being', the word `being',
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
869 the words `each' or `the', and the difference between singular and plural
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
870 keywords are all just syntactic sugar. Stylistically, you should write
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
871 either `being each foo' or `being the foos'.)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
872
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
873 for VAR from/upfrom/downfrom NUM1 to/upto/downto/above/below NUM2 [by NUMSTEP]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
874 Step VAR across numbers. `upfrom', `upto', and `below' explicitly
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
875 indicate upward stepping\; `downfrom', `downto', and `above' explicitly
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
876 indicate downward stepping. (If none of these is given, the default is
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
877 upward.) `to', `upto', and `downto' cause stepping to include NUM2 as
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
878 the last iteration, while `above' and `below' stop just before reaching
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
879 NUM2. `by' can be given to indicate a stepping increment other than 1.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
880
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
881 for VAR in LIST [by FUNC]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
882 Step VAR over elements of a LIST. FUNC specifies how to get successive
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
883 sublists and defaults to `cdr'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
884
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
885 for VAR on LIST [by FUNC]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
886 Step VAR over tails of a LIST. FUNC specifies how to get successive
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
887 sublists and defaults to `cdr'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
888
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
889 for VAR in-ref LIST [by FUNC]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
890 Step VAR over elements of a LIST, like `for ... in', except the VAR is
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
891 bound using `symbol-macrolet' instead of `let'. In essence, VAR is set
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
892 to a \"reference\" to the list element instead of the element itself\;
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
893 this us, you can destructively modify the list using `setf' on VAR, and
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
894 any changes to the list will \"magically\" reflect themselves in
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
895 subsequent uses of VAR.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
896
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
897 for VAR = INIT [then EXPR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
898 Set VAR on each iteration of the loop. If only INIT is given, use it
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
899 on each iteration. Otherwise, use INIT on the first iteration and EXPR
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
900 on subsequent ones.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
901
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
902 for VAR across/across-ref ARRAY
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
903 Step VAR across a sequence other than a list (string, vector, bit
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
904 vector). If `across-ref' is given, VAR is bound using
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
905 `symbol-macrolet' instead of `let' -- see above.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
906
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
907 for VAR being each/the element/elements in/of/in-ref/of-ref SEQUENCE [using (index INDEX-VAR)]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
908 Step VAR across any sequence. A variable can be specified with a
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
909 `using' phrase to receive the index, starting at 0. If `in-ref' or
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
910 `of-ref' is given, VAR is bound using `symbol-macrolet' instead of
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
911 `let' -- see above.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
912
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
913 for VAR being each/the hash-key/hash-keys/hash-value/hash-values in/of HASH-TABLE [using (hash-value/hash-key OTHER-VAR)]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
914
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
915 for VAR being each/the hash-key/hash-keys/hash-value/hash-values in/of HASH-TABLE [using (hash-value/hash-key OTHER-VAR)]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
916 Map VAR over a hash table. The various keywords are synonymous except
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
917 those that distinguish between keys and values. The `using' phrase is
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
918 optional and allows both key and value to be bound.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
919
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
920 for VAR being each/the symbol/present-symbol/external-symbol/symbols/present-symbols/external-symbols in/of OBARRAY
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
921 Map VAR over the symbols in an obarray. All symbol keywords are
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
922 currently synonymous.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
923
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
924 for VAR being each/the extent/extents [in/of BUFFER-OR-STRING] [from POS] [to POS]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
925 Map VAR over the extents in a buffer or string, defaulting to the
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
926 current buffer, the beginning and the end, respectively.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
927
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
928 for VAR being each/the interval/intervals [in/of BUFFER-OR-STRING] [property PROPERTY] [from POS] [to POS]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
929 Map VAR over the intervals without property change in a buffer or
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
930 string, defaulting to the current buffer, the beginning and the end,
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
931 respectively. If PROPERTY is given, iteration occurs using
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
932 `next-single-property-change'\; otherwise, using
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
933 `next-property-change'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
934
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
935 for VAR being each/the window/windows [in/of FRAME]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
936 Step VAR over the windows in FRAME, defaulting to the selected frame.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
937
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
938 for VAR being each/the frame/frames
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
939 Step VAR over all frames.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
940
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
941 for VAR being each/the buffer/buffers [by FUNC]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
942 Step VAR over all buffers. This is actually equivalent to
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
943 `for VAR in (buffer-list) [by FUNC]'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
944
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
945 for VAR being each/the key-code/key-codes/key-seq/key-seqs/key-binding/key-bindings in KEYMAP [using (key-code/key-codes/key-seq/key-seqs/key-binding/key-bindings OTHER-VAR)]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
946 Map VAR over the entries in a keymap. Keyword `key-seq' causes
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
947 recursive mapping over prefix keymaps occurring in the keymap, with VAR
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
948 getting the built-up sequence (a vector). Otherwise, mapping does not
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
949 occur recursively. `key-code' and `key-seq' refer to what is bound
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
950 (second argument of `define-key'), and `key-binding' what it's bound to
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
951 (third argument of `define-key').
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
952
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
953 as VAR ...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
954 `as' is a synonym for `for'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
955
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
956 and VAR ...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
957 `and' clauses have the same syntax as `for' clauses except that the
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
958 variables in the clause are bound in parallel with a preceding
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
959 `and'/`for' clause instead of in series.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
960
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
961 with VAR = INIT
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
962 Set VAR to INIT once, before doing any iterations.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
963
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
964 repeat NUM
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
965 Exit the loop if more than NUM iterations have occurred.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
966
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
967 while COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
968 Exit the loop if COND isn't true.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
969
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
970 until COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
971 Exit the loop if COND is true.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
972
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
973 collect EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
974 Push EXPR onto the end of a list of values -- stored either in VAR or a
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
975 temporary variable that will be returned as the return value of the
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
976 loop if it terminates through an exit condition or a call to
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
977 `loop-finish'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
978
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
979 append EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
980 Append EXPR (a list) onto the end of a list of values, like `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
981
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
982 nconc EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
983 Nconc EXPR (a list) onto the end of a list of values, like `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
984
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
985 concat EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
986 Concatenate EXPR (a string) onto the end of a string of values, like
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
987 `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
988
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
989 vconcat EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
990 Concatenate EXPR (a vector) onto the end of a vector of values, like
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
991 `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
992
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
993 bvconcat EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
994 Concatenate EXPR (a bit vector) onto the end of a bit vector of values,
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
995 like `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
996
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
997 sum EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
998 Add EXPR to a value, like `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
999
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1000 count EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1001 If EXPR is true, increment a value by 1, like `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1002
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1003 maximize EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1004 IF EXPR is greater than a value, replace the value with EXPR, like
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1005 `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1006
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1007 minimize EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1008 IF EXPR is less than a value, replace the value with EXPR, like
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1009 `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1010
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1011 always COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1012 If COND is true, continue the loop and set the loop return value (the
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1013 same value that's manipulated by `collect' and friends and is returned
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1014 by a normal loop exit or an exit using `loop-finish') to t\; otherwise,
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1015 exit the loop and return nil. The effect is to determine and return
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1016 whether a condition is true \"always\" (all iterations of the loop).
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1017
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1018 never COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1019 If COND is false, continue the loop and set the loop return value (like
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1020 `always') to t\; otherwise, exit the loop and return nil. The effect
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1021 is to determine and return whether a condition is \"never\" true (all
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1022 iterations of the loop).
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1023
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1024 thereis COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1025 If COND is true, exit the loop and return COND.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1026
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1027 if/when COND CLAUSE [and CLAUSE]... else CLAUSE [and CLAUSE...]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1028 If COND is true, execute the directly following clause(s)\; otherwise,
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1029 execute the clauses following `else'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1030
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1031 unless COND CLAUSE [and CLAUSE]... else CLAUSE [and CLAUSE...]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1032 If COND is false, execute the directly following clause(s)\; otherwise, execute the clauses following `else'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1033
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1034 do EXPRS...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1035 Execute the expressions (any Lisp forms).
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1036
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1037 initially EXPRS...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1038 Execute EXPR once, before doing any iterations, and after values have
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1039 been set using `with'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1040
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1041 finally EXPRS...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1042 Execute EXPR once, directly before the loop terminates. This will not
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1043 be executed if the loop terminates prematurely as a result of `always',
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1044 `never', `thereis', or `return'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1045
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1046 return EXPR
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1047 Exit from the loop and return EXPR.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1048
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1049 finally return EXPR
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1050 Specify the value to be returned when the loop exits. (Unlike `return',
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1051 this doesn't cause the loop to immediately exit\; it will exit whenever
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1052 it normally would have.) This takes precedence over a return value
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1053 specified with `collect' and friends or `always' and friends.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1054
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1055 named NAME
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1056 Specify the name for block surrounding the loop, in place of nil.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1057 (See `block'.)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1058 "
5367
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
1059 (if (notany #'symbolp (set-difference clauses '(nil t)))
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1060 (list 'block nil (list* 'while t clauses))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1061 (let ((loop-name nil) (loop-bindings nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1062 (loop-body nil) (loop-steps nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1063 (loop-result nil) (loop-result-explicit nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1064 (loop-result-var nil) (loop-finish-flag nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1065 (loop-accum-var nil) (loop-accum-vars nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1066 (loop-initially nil) (loop-finally nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1067 (loop-map-form nil) (loop-first-flag nil)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1068 (loop-destr-temps nil) (loop-symbol-macs nil)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1069 (args (append clauses '(cl-end-loop))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1070 (while (not (eq (car args) 'cl-end-loop)) (cl-parse-loop-clause))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1071 (if loop-finish-flag
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1072 (push (list (list loop-finish-flag t)) loop-bindings))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1073 (if loop-first-flag
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1074 (progn (push (list (list loop-first-flag t)) loop-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1075 (push (list 'setq loop-first-flag nil) loop-steps)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1076 (let* ((epilogue (nconc (nreverse loop-finally)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1077 (list (or loop-result-explicit loop-result))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1078 (ands (cl-loop-build-ands (nreverse loop-body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1079 (while-body (nconc (cadr ands) (nreverse loop-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1080 (body (append
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1081 (nreverse loop-initially)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1082 (list (if loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1083 (list 'block '--cl-finish--
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1084 (subst
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1085 (if (eq (car ands) t) while-body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1086 (cons (list 'or (car ands)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1087 '(return-from --cl-finish--
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1088 nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1089 while-body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1090 '--cl-map loop-map-form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1091 (list* 'while (car ands) while-body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1092 (if loop-finish-flag
1346
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1093 (if (equal epilogue '(nil))
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1094 ;; XEmacs change: When epilogue is nil and
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1095 ;; loop-finish-flag exists, you get a byte-compiler
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1096 ;; warning using the original (commented-out)
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1097 ;; code below. So instead we create a form that
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1098 ;; gives the same result but uses loop-finish-flag.
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1099 ;; --ben
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1100 ;(list loop-result-var)
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1101 (list (list 'if loop-finish-flag
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1102 loop-result-var loop-result-var))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1103 (list (list 'if loop-finish-flag
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1104 (cons 'progn epilogue) loop-result-var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1105 epilogue))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1106 (if loop-result-var (push (list loop-result-var) loop-bindings))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1107 (while loop-bindings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1108 (if (cdar loop-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1109 (setq body (list (cl-loop-let (pop loop-bindings) body t)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1110 (let ((lets nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1111 (while (and loop-bindings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1112 (not (cdar loop-bindings)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1113 (push (car (pop loop-bindings)) lets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1114 (setq body (list (cl-loop-let lets body nil))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1115 (if loop-symbol-macs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1116 (setq body (list (list* 'symbol-macrolet loop-symbol-macs body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1117 (list* 'block loop-name body)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1118
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1119 (defun cl-parse-loop-clause () ; uses args, loop-*
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1120 (let ((word (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1121 (hash-types '(hash-key hash-keys hash-value hash-values))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1122 (key-types '(key-code key-codes key-seq key-seqs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1123 key-binding key-bindings)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1124 (cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1125
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1126 ((null args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1127 (error "Malformed `loop' macro"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1128
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1129 ((eq word 'named)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1130 (setq loop-name (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1131
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1132 ((eq word 'initially)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1133 (if (memq (car args) '(do doing)) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1134 (or (consp (car args)) (error "Syntax error on `initially' clause"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1135 (while (consp (car args))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1136 (push (pop args) loop-initially)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1137
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1138 ((eq word 'finally)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1139 (if (eq (car args) 'return)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1140 (setq loop-result-explicit (or (cl-pop2 args) '(quote nil)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1141 (if (memq (car args) '(do doing)) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1142 (or (consp (car args)) (error "Syntax error on `finally' clause"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1143 (if (and (eq (caar args) 'return) (null loop-name))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1144 (setq loop-result-explicit (or (nth 1 (pop args)) '(quote nil)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1145 (while (consp (car args))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1146 (push (pop args) loop-finally)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1147
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1148 ((memq word '(for as))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1149 (let ((loop-for-bindings nil) (loop-for-sets nil) (loop-for-steps nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1150 (ands nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1151 (while
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1152 (let ((var (or (pop args) (gensym))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1153 (setq word (pop args))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1154 (if (eq word 'being) (setq word (pop args)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1155 (if (memq word '(the each)) (setq word (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1156 (if (memq word '(buffer buffers))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1157 (setq word 'in args (cons '(buffer-list) args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1158 (cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1159
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1160 ((memq word '(from downfrom upfrom to downto upto
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1161 above below by))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1162 (push word args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1163 (if (memq (car args) '(downto above))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1164 (error "Must specify `from' value for downward loop"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1165 (let* ((down (or (eq (car args) 'downfrom)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1166 (memq (caddr args) '(downto above))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1167 (excl (or (memq (car args) '(above below))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1168 (memq (caddr args) '(above below))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1169 (start (and (memq (car args) '(from upfrom downfrom))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1170 (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1171 (end (and (memq (car args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1172 '(to upto downto above below))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1173 (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1174 (step (and (eq (car args) 'by) (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1175 (end-var (and (not (cl-const-expr-p end)) (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1176 (step-var (and (not (cl-const-expr-p step))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1177 (gensym))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1178 (and step (numberp step) (<= step 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1179 (error "Loop `by' value is not positive: %s" step))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1180 (push (list var (or start 0)) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1181 (if end-var (push (list end-var end) loop-for-bindings))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1182 (if step-var (push (list step-var step)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1183 loop-for-bindings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1184 (if end
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1185 (push (list
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1186 (if down (if excl '> '>=) (if excl '< '<=))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1187 var (or end-var end)) loop-body))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1188 (push (list var (list (if down '- '+) var
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1189 (or step-var step 1)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1190 loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1191
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1192 ((memq word '(in in-ref on))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1193 (let* ((on (eq word 'on))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1194 (temp (if (and on (symbolp var)) var (gensym))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1195 (push (list temp (pop args)) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1196 (push (list 'consp temp) loop-body)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1197 (if (eq word 'in-ref)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1198 (push (list var (list 'car temp)) loop-symbol-macs)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1199 (or (eq temp var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1200 (progn
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1201 (push (list var nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1202 (push (list var (if on temp (list 'car temp)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1203 loop-for-sets))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1204 (push (list temp
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1205 (if (eq (car args) 'by)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1206 (let ((step (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1207 (if (and (memq (car-safe step)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1208 '(quote function
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1209 function*))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1210 (symbolp (nth 1 step)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1211 (list (nth 1 step) temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1212 (list 'funcall step temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1213 (list 'cdr temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1214 loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1215
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1216 ((eq word '=)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1217 (let* ((start (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1218 (then (if (eq (car args) 'then) (cl-pop2 args) start)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1219 (push (list var nil) loop-for-bindings)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1220 (if (or ands (eq (car args) 'and))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1221 (progn
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1222 (push (list var
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1223 (list 'if
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1224 (or loop-first-flag
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1225 (setq loop-first-flag
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1226 (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1227 start var))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1228 loop-for-sets)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1229 (push (list var then) loop-for-steps))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1230 (push (list var
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1231 (if (eq start then) start
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1232 (list 'if
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1233 (or loop-first-flag
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1234 (setq loop-first-flag (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1235 start then)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1236 loop-for-sets))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1237
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1238 ((memq word '(across across-ref))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1239 (let ((temp-vec (gensym)) (temp-idx (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1240 (push (list temp-vec (pop args)) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1241 (push (list temp-idx -1) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1242 (push (list '< (list 'setq temp-idx (list '1+ temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1243 (list 'length temp-vec)) loop-body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1244 (if (eq word 'across-ref)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1245 (push (list var (list 'aref temp-vec temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1246 loop-symbol-macs)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1247 (push (list var nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1248 (push (list var (list 'aref temp-vec temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1249 loop-for-sets))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1250
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1251 ((memq word '(element elements))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1252 (let ((ref (or (memq (car args) '(in-ref of-ref))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1253 (and (not (memq (car args) '(in of)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1254 (error "Expected `of'"))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1255 (seq (cl-pop2 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1256 (temp-seq (gensym))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1257 (temp-idx (if (eq (car args) 'using)
5366
f00192e1cd49 Examining the result of #'length: `eql', not `=', it's better style & cheaper
Aidan Kehoe <kehoea@parhasard.net>
parents: 5356
diff changeset
1258 (if (and (eql (length (cadr args)) 2)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1259 (eq (caadr args) 'index))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1260 (cadr (cl-pop2 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1261 (error "Bad `using' clause"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1262 (gensym))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1263 (push (list temp-seq seq) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1264 (push (list temp-idx 0) loop-for-bindings)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1265 (if ref
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1266 (let ((temp-len (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1267 (push (list temp-len (list 'length temp-seq))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1268 loop-for-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1269 (push (list var (list 'elt temp-seq temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1270 loop-symbol-macs)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1271 (push (list '< temp-idx temp-len) loop-body))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1272 (push (list var nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1273 (push (list 'and temp-seq
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1274 (list 'or (list 'consp temp-seq)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1275 (list '< temp-idx
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1276 (list 'length temp-seq))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1277 loop-body)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1278 (push (list var (list 'if (list 'consp temp-seq)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1279 (list 'pop temp-seq)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1280 (list 'aref temp-seq temp-idx)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1281 loop-for-sets))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1282 (push (list temp-idx (list '1+ temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1283 loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1284
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1285 ((memq word hash-types)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1286 (or (memq (car args) '(in of)) (error "Expected `of'"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1287 (let* ((table (cl-pop2 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1288 (other (if (eq (car args) 'using)
5366
f00192e1cd49 Examining the result of #'length: `eql', not `=', it's better style & cheaper
Aidan Kehoe <kehoea@parhasard.net>
parents: 5356
diff changeset
1289 (if (and (eql (length (cadr args)) 2)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1290 (memq (caadr args) hash-types)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1291 (not (eq (caadr args) word)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1292 (cadr (cl-pop2 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1293 (error "Bad `using' clause"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1294 (gensym))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1295 (if (memq word '(hash-value hash-values))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1296 (setq var (prog1 other (setq other var))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1297 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1298 (list 'maphash (list 'function
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1299 (list* 'lambda (list var other)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1300 '--cl-map)) table))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1301
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1302 ((memq word '(symbol present-symbol external-symbol
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1303 symbols present-symbols external-symbols))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1304 (let ((ob (and (memq (car args) '(in of)) (cl-pop2 args))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1305 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1306 (list 'mapatoms (list 'function
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1307 (list* 'lambda (list var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1308 '--cl-map)) ob))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1309
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1310 ((memq word '(overlay overlays extent extents))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1311 (let ((buf nil) (from nil) (to nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1312 (while (memq (car args) '(in of from to))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1313 (cond ((eq (car args) 'from) (setq from (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1314 ((eq (car args) 'to) (setq to (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1315 (t (setq buf (cl-pop2 args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1316 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1317 (list 'cl-map-extents
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1318 (list 'function (list 'lambda (list var (gensym))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1319 '(progn . --cl-map) nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1320 buf from to))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1321
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1322 ((memq word '(interval intervals))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1323 (let ((buf nil) (prop nil) (from nil) (to nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1324 (var1 (gensym)) (var2 (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1325 (while (memq (car args) '(in of property from to))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1326 (cond ((eq (car args) 'from) (setq from (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1327 ((eq (car args) 'to) (setq to (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1328 ((eq (car args) 'property)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1329 (setq prop (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1330 (t (setq buf (cl-pop2 args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1331 (if (and (consp var) (symbolp (car var)) (symbolp (cdr var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1332 (setq var1 (car var) var2 (cdr var))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1333 (push (list var (list 'cons var1 var2)) loop-for-sets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1334 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1335 (list 'cl-map-intervals
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1336 (list 'function (list 'lambda (list var1 var2)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1337 '(progn . --cl-map)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1338 buf prop from to))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1339
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1340 ((memq word key-types)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1341 (or (memq (car args) '(in of)) (error "Expected `of'"))
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1342 (let* ((map (cl-pop2 args))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1343 other-word
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1344 (other (if (eq (car args) 'using)
5366
f00192e1cd49 Examining the result of #'length: `eql', not `=', it's better style & cheaper
Aidan Kehoe <kehoea@parhasard.net>
parents: 5356
diff changeset
1345 (if (and (eql (length (cadr args)) 2)
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1346 (memq (setq other-word (caadr args))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1347 key-types)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1348 (not (eq (caadr args) word)))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1349 (cadr (cl-pop2 args))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1350 (error "Bad `using' clause"))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1351 (gensym))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1352 ;; XEmacs addition: track other-word
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1353 (when (memq word '(key-binding key-bindings))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1354 (setq var (prog1 other (setq other var)))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1355 (and other-word (setq word other-word)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1356 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1357 (list (if (memq word '(key-seq key-seqs))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1358 'cl-map-keymap-recursively 'map-keymap)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1359 (list 'function (list* 'lambda (list var other)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1360 '--cl-map)) map))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1361
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1362 ((memq word '(frame frames screen screens))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1363 (let ((temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1364 (push (list var '(selected-frame))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1365 loop-for-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1366 (push (list temp nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1367 (push (list 'prog1 (list 'not (list 'eq var temp))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1368 (list 'or temp (list 'setq temp var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1369 loop-body)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1370 (push (list var (list 'next-frame var))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1371 loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1372
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1373 ((memq word '(window windows))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1374 (let ((scr (and (memq (car args) '(in of)) (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1375 (temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1376 (push (list var (if scr
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1377 (list 'frame-selected-window scr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1378 '(selected-window)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1379 loop-for-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1380 (push (list temp nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1381 (push (list 'prog1 (list 'not (list 'eq var temp))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1382 (list 'or temp (list 'setq temp var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1383 loop-body)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1384 (push (list var (list 'next-window var)) loop-for-steps)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1385
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1386 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1387 (let ((handler (and (symbolp word)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1388 (get word 'cl-loop-for-handler))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1389 (if handler
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1390 (funcall handler var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1391 (error "Expected a `for' preposition, found %s" word)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1392 (eq (car args) 'and))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1393 (setq ands t)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1394 (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1395 (if (and ands loop-for-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1396 (push (nreverse loop-for-bindings) loop-bindings)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1397 (setq loop-bindings (nconc (mapcar 'list loop-for-bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1398 loop-bindings)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1399 (if loop-for-sets
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1400 (push (list 'progn
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1401 (cl-loop-let (nreverse loop-for-sets) 'setq ands)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1402 t) loop-body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1403 (if loop-for-steps
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1404 (push (cons (if ands 'psetq 'setq)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1405 (apply 'append (nreverse loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1406 loop-steps))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1407
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1408 ((eq word 'repeat)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1409 (let ((temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1410 (push (list (list temp (pop args))) loop-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1411 (push (list '>= (list 'setq temp (list '1- temp)) 0) loop-body)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1412
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1413 ((memq word '(collect collecting))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1414 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1415 (var (cl-loop-handle-accum nil 'nreverse)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1416 (if (eq var loop-accum-var)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1417 (push (list 'progn (list 'push what var) t) loop-body)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1418 (push (list 'progn
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1419 (list 'setq var (list 'nconc var (list 'list what)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1420 t) loop-body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1421
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1422 ((memq word '(nconc nconcing append appending))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1423 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1424 (var (cl-loop-handle-accum nil 'nreverse)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1425 (push (list 'progn
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1426 (list 'setq var
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1427 (if (eq var loop-accum-var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1428 (list 'nconc
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1429 (list (if (memq word '(nconc nconcing))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1430 'nreverse 'reverse)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1431 what)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1432 var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1433 (list (if (memq word '(nconc nconcing))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1434 'nconc 'append)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1435 var what))) t) loop-body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1436
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1437 ((memq word '(concat concating))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1438 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1439 (var (cl-loop-handle-accum "")))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1440 (push (list 'progn (list 'callf 'concat var what) t) loop-body)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1441
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1442 ((memq word '(vconcat vconcating))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1443 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1444 (var (cl-loop-handle-accum [])))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1445 (push (list 'progn (list 'callf 'vconcat var what) t) loop-body)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1446
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1447 ;; XEmacs addition: handle bit-vectors
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1448 ((memq word '(bvconcat bvconcating))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1449 (let ((what (pop args))
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1450 (var (cl-loop-handle-accum #*)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1451 (push (list 'progn (list 'callf 'bvconcat var what) t) loop-body)))
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1452
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1453 ((memq word '(sum summing))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1454 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1455 (var (cl-loop-handle-accum 0)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1456 (push (list 'progn (list 'incf var what) t) loop-body)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1457
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1458 ((memq word '(count counting))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1459 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1460 (var (cl-loop-handle-accum 0)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1461 (push (list 'progn (list 'if what (list 'incf var)) t) loop-body)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1462
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1463 ((memq word '(minimize minimizing maximize maximizing))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1464 (let* ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1465 (temp (if (cl-simple-expr-p what) what (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1466 (var (cl-loop-handle-accum nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1467 (func (intern (substring (symbol-name word) 0 3)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1468 (set (list 'setq var (list 'if var (list func var temp) temp))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1469 (push (list 'progn (if (eq temp what) set
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1470 (list 'let (list (list temp what)) set))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1471 t) loop-body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1472
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1473 ((eq word 'with)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1474 (let ((bindings nil))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1475 (while (progn (push (list (pop args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1476 (and (eq (car args) '=) (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1477 bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1478 (eq (car args) 'and))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1479 (pop args))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1480 (push (nreverse bindings) loop-bindings)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1481
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1482 ((eq word 'while)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1483 (push (pop args) loop-body))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1484
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1485 ((eq word 'until)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1486 (push (list 'not (pop args)) loop-body))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1487
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1488 ((eq word 'always)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1489 (or loop-finish-flag (setq loop-finish-flag (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1490 (push (list 'setq loop-finish-flag (pop args)) loop-body)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1491 (setq loop-result t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1492
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1493 ((eq word 'never)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1494 (or loop-finish-flag (setq loop-finish-flag (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1495 (push (list 'setq loop-finish-flag (list 'not (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1496 loop-body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1497 (setq loop-result t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1498
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1499 ((eq word 'thereis)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1500 (or loop-finish-flag (setq loop-finish-flag (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1501 (or loop-result-var (setq loop-result-var (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1502 (push (list 'setq loop-finish-flag
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1503 (list 'not (list 'setq loop-result-var (pop args))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1504 loop-body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1505
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1506 ((memq word '(if when unless))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1507 (let* ((cond (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1508 (then (let ((loop-body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1509 (cl-parse-loop-clause)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1510 (cl-loop-build-ands (nreverse loop-body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1511 (else (let ((loop-body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1512 (if (eq (car args) 'else)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1513 (progn (pop args) (cl-parse-loop-clause)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1514 (cl-loop-build-ands (nreverse loop-body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1515 (simple (and (eq (car then) t) (eq (car else) t))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1516 (if (eq (car args) 'end) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1517 (if (eq word 'unless) (setq then (prog1 else (setq else then))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1518 (let ((form (cons (if simple (cons 'progn (nth 1 then)) (nth 2 then))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1519 (if simple (nth 1 else) (list (nth 2 else))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1520 (if (cl-expr-contains form 'it)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1521 (let ((temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1522 (push (list temp) loop-bindings)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1523 (setq form (list* 'if (list 'setq temp cond)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1524 (subst temp 'it form))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1525 (setq form (list* 'if cond form)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1526 (push (if simple (list 'progn form t) form) loop-body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1527
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1528 ((memq word '(do doing))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1529 (let ((body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1530 (or (consp (car args)) (error "Syntax error on `do' clause"))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1531 (while (consp (car args)) (push (pop args) body))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1532 (push (cons 'progn (nreverse (cons t body))) loop-body)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1533
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1534 ((eq word 'return)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1535 (or loop-finish-flag (setq loop-finish-flag (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1536 (or loop-result-var (setq loop-result-var (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1537 (push (list 'setq loop-result-var (pop args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1538 loop-finish-flag nil) loop-body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1539
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1540 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1541 (let ((handler (and (symbolp word) (get word 'cl-loop-handler))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1542 (or handler (error "Expected a loop keyword, found %s" word))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1543 (funcall handler))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1544 (if (eq (car args) 'and)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1545 (progn (pop args) (cl-parse-loop-clause)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1546
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1547 (defun cl-loop-let (specs body par) ; uses loop-*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1548 (let ((p specs) (temps nil) (new nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1549 (while (and p (or (symbolp (car-safe (car p))) (null (cadar p))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1550 (setq p (cdr p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1551 (and par p
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1552 (progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1553 (setq par nil p specs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1554 (while p
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1555 (or (cl-const-expr-p (cadar p))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1556 (let ((temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1557 (push (list temp (cadar p)) temps)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1558 (setcar (cdar p) temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1559 (setq p (cdr p)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1560 (while specs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1561 (if (and (consp (car specs)) (listp (caar specs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1562 (let* ((spec (caar specs)) (nspecs nil)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1563 (expr (cadr (pop specs)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1564 (temp (cdr (or (assq spec loop-destr-temps)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1565 (car (push (cons spec (or (last spec 0)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1566 (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1567 loop-destr-temps))))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1568 (push (list temp expr) new)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1569 (while (consp spec)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1570 (push (list (pop spec)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1571 (and expr (list (if spec 'pop 'car) temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1572 nspecs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1573 (setq specs (nconc (nreverse nspecs) specs)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1574 (push (pop specs) new)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1575 (if (eq body 'setq)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1576 (let ((set (cons (if par 'psetq 'setq) (apply 'nconc (nreverse new)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1577 (if temps (list 'let* (nreverse temps) set) set))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1578 (list* (if par 'let 'let*)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1579 (nconc (nreverse temps) (nreverse new)) body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1580
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1581 (defun cl-loop-handle-accum (def &optional func) ; uses args, loop-*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1582 (if (eq (car args) 'into)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1583 (let ((var (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1584 (or (memq var loop-accum-vars)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1585 (progn (push (list (list var def)) loop-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1586 (push var loop-accum-vars)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1587 var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1588 (or loop-accum-var
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1589 (progn
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1590 (push (list (list (setq loop-accum-var (gensym)) def))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1591 loop-bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1592 (setq loop-result (if func (list func loop-accum-var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1593 loop-accum-var))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1594 loop-accum-var))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1595
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1596 (defun cl-loop-build-ands (clauses)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1597 (let ((ands nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1598 (body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1599 (while clauses
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1600 (if (and (eq (car-safe (car clauses)) 'progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1601 (eq (car (last (car clauses))) t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1602 (if (cdr clauses)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1603 (setq clauses (cons (nconc (butlast (car clauses))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1604 (if (eq (car-safe (cadr clauses))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1605 'progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1606 (cdadr clauses)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1607 (list (cadr clauses))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1608 (cddr clauses)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1609 (setq body (cdr (butlast (pop clauses)))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1610 (push (pop clauses) ands)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1611 (setq ands (or (nreverse ands) (list t)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1612 (list (if (cdr ands) (cons 'and ands) (car ands))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1613 body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1614 (let ((full (if body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1615 (append ands (list (cons 'progn (append body '(t)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1616 ands)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1617 (if (cdr full) (cons 'and full) (car full))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1618
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1619
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1620 ;;; Other iteration control structures.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1621
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1622 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1623 (defmacro do (steps endtest &rest body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1624 "The Common Lisp `do' loop.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1625 Format is: (do ((VAR INIT [STEP])...) (END-TEST [RESULT...]) BODY...)"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1626 (cl-expand-do-loop steps endtest body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1627
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1628 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1629 (defmacro do* (steps endtest &rest body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1630 "The Common Lisp `do*' loop.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1631 Format is: (do* ((VAR INIT [STEP])...) (END-TEST [RESULT...]) BODY...)"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1632 (cl-expand-do-loop steps endtest body t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1633
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1634 (defun cl-expand-do-loop (steps endtest body star)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1635 (list 'block nil
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1636 (list* (if star 'let* 'let)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1637 (mapcar #'(lambda (c) (if (consp c) (list (car c) (nth 1 c)) c))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1638 steps)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1639 (list* 'while (list 'not (car endtest))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1640 (append body
5367
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
1641 (let ((sets (mapcan
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1642 #'(lambda (c)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1643 (and (consp c) (cdr (cdr c))
5367
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
1644 (list
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
1645 (list (car c) (nth 2 c)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1646 steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1647 (and sets
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1648 (list (cons (if (or star (not (cdr sets)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1649 'setq 'psetq)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1650 (apply 'append sets)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1651 (or (cdr endtest) '(nil)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1652
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1653 ;;;###autoload
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1654 (defmacro* dolist ((var list &optional result) &body body)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1655 "Loop over a list.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1656 Evaluate BODY with VAR bound to each `car' from LIST, in turn.
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1657 Then evaluate RESULT to get return value, default nil."
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1658 (let ((gensym (gensym)))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1659 `(block nil
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1660 (let ((,gensym ,list) ,var)
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1661 (while ,gensym
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1662 (setq ,var (car ,gensym))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1663 ,@body
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1664 (setq ,gensym (cdr ,gensym)))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1665 ,@(if result `((setq ,var nil) ,result))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1666
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1667 ;;;###autoload
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1668 (defmacro* dotimes ((var count &optional result) &body body)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1669 "Loop a certain number of times.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1670 Evaluate BODY with VAR bound to successive integers from 0, inclusive,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1671 to COUNT, exclusive. Then evaluate RESULT to get return value, default
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1672 nil."
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1673 (let* ((limit (if (cl-const-expr-p count) count (gensym)))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1674 (bind (if (cl-const-expr-p count) nil `((,limit ,count)))))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1675 `(block nil
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1676 (let ((,var 0) ,@bind)
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1677 (while (< ,var ,limit)
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1678 ,@body
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1679 (setq ,var (1+ ,var)))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1680 ,@(if result (list result))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1681
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1682 ;;;###autoload
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1683 (defmacro* do-symbols ((var &optional obarray result) &rest body)
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1684 "Loop over all interned symbols.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1685 Evaluate BODY with VAR bound to each interned symbol, or to each symbol
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1686 from OBARRAY."
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1687 `(block nil
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1688 (mapatoms #'(lambda (,var) ,@body) ,@(and obarray (list obarray)))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1689 ,@(if result `((let (,var) ,result)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1690
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1691 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1692 (defmacro do-all-symbols (spec &rest body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1693 (list* 'do-symbols (list (car spec) nil (cadr spec)) body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1694
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1695
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1696 ;;; Assignments.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1697
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1698 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1699 (defmacro psetq (&rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1700 "(psetq SYM VAL SYM VAL ...): set SYMs to the values VALs in parallel.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1701 This is like `setq', except that all VAL forms are evaluated (in order)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1702 before assigning any symbols SYM to the corresponding values."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1703 (cons 'psetf args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1704
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1705
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1706 ;;; Binding control structures.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1707
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1708 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1709 (defmacro progv (symbols values &rest body)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
1710 "Bind SYMBOLS to VALUES dynamically in BODY.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1711 The forms SYMBOLS and VALUES are evaluated, and must evaluate to lists.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1712 Each SYMBOL in the first list is bound to the corresponding VALUE in the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1713 second list (or made unbound if VALUES is shorter than SYMBOLS); then the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1714 BODY forms are executed and their result is returned. This is much like
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1715 a `let' form, except that the list of symbols can be computed at run-time."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1716 (list 'let '((cl-progv-save nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1717 (list 'unwind-protect
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1718 (list* 'progn (list 'cl-progv-before symbols values) body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1719 '(cl-progv-after))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1720
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1721 ;;; This should really have some way to shadow 'byte-compile properties, etc.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1722 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1723 (defmacro flet (bindings &rest body)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1724 "Make temporary function definitions.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1725 This is an analogue of `let' that operates on the function cell of FUNC
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1726 rather than its value cell. The FORMs are evaluated with the specified
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1727 function definitions in place, then the definitions are undone (the FUNCs
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1728 go back to their previous definitions, or lack thereof).
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1729
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1730 arguments: (((FUNC ARGLIST &body BODY) &rest FUNCTIONS) &body FORM)"
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1731 (list* 'letf*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1732 (mapcar
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1733 #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1734 (if (or (and (fboundp (car x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1735 (eq (car-safe (symbol-function (car x))) 'macro))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1736 (cdr (assq (car x) cl-macro-environment)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1737 (error "Use `labels', not `flet', to rebind macro names"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1738 (let ((func (list 'function*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1739 (list 'lambda (cadr x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1740 (list* 'block (car x) (cddr x))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1741 (if (and (cl-compiling-file)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1742 (boundp 'byte-compile-function-environment))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1743 (push (cons (car x) (eval func))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1744 byte-compile-function-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1745 (list (list 'symbol-function (list 'quote (car x))) func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1746 bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1747 body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1748
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1749 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1750 (defmacro labels (bindings &rest body)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1751 "Make temporary func bindings.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1752 This is like `flet', except the bindings are lexical instead of dynamic.
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1753 Unlike `flet', this macro is fully compliant with the Common Lisp standard.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1754
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1755 arguments: (((FUNC ARGLIST &body BODY) &rest FUNCTIONS) &body FORM)"
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1756 (let ((vars nil) (sets nil) (cl-macro-environment cl-macro-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1757 (while bindings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1758 (let ((var (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1759 (push var vars)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1760 (push (list 'function* (cons 'lambda (cdar bindings))) sets)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1761 (push var sets)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1762 (push (list (car (pop bindings)) 'lambda '(&rest cl-labels-args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1763 (list 'list* '(quote funcall) (list 'quote var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1764 'cl-labels-args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1765 cl-macro-environment)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1766 (cl-macroexpand-all (list* 'lexical-let vars (cons (cons 'setq sets) body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1767 cl-macro-environment)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1768
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1769 ;; The following ought to have a better definition for use with newer
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1770 ;; byte compilers.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1771 ;;;###autoload
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1772 (defmacro* macrolet (((name arglist &optional docstring &body body)
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1773 &rest macros) &body form)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1774 "Make temporary macro definitions.
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1775 This is like `flet', but for macros instead of functions."
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1776 (cl-macroexpand-all (cons 'progn form)
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1777 (nconc
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1778 (loop
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1779 for (name . details)
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1780 in (cons (list* name arglist docstring body) macros)
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1781 collect
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1782 (list* name 'lambda
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1783 (prog1
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1784 (cdr (setq details (cl-transform-lambda
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1785 details name)))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1786 (eval (car details)))))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1787 cl-macro-environment)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1788
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1789 ;;;###autoload
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1790 (defmacro* symbol-macrolet (((name expansion) &rest symbol-macros) &body form)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1791 "Make symbol macro definitions.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1792 Within the body FORMs, references to the variable NAME will be replaced
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1793 by EXPANSION, and (setq NAME ...) will act like (setf EXPANSION ...)."
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1794 (cl-macroexpand-all (cons 'progn form)
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1795 (append (list (list (symbol-name name) expansion))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1796 (loop
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1797 for (name expansion) in symbol-macros
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1798 collect (list (symbol-name name) expansion))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1799 cl-macro-environment)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1800
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1801 (defvar cl-closure-vars nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1802 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1803 (defmacro lexical-let (bindings &rest body)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
1804 "Like `let', but lexically scoped.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1805 The main visible difference is that lambdas inside BODY will create
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1806 lexical closures as in Common Lisp."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1807 (let* ((cl-closure-vars cl-closure-vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1808 (vars (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1809 (or (consp x) (setq x (list x)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1810 (push (gensym (format "--%s--" (car x)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1811 cl-closure-vars)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1812 (set (car cl-closure-vars) [bad-lexical-ref])
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1813 (list (car x) (cadr x) (car cl-closure-vars)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1814 bindings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1815 (ebody
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1816 (cl-macroexpand-all
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1817 (cons 'progn body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1818 (nconc (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1819 (list (symbol-name (car x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1820 (list 'symbol-value (caddr x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1821 t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1822 vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1823 (list '(defun . cl-defun-expander))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1824 cl-macro-environment))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1825 (if (not (get (car (last cl-closure-vars)) 'used))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1826 (list 'let (mapcar #'(lambda (x) (list (caddr x) (cadr x))) vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1827 (sublis (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1828 (cons (caddr x) (list 'quote (caddr x))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1829 vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1830 ebody))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1831 (list 'let (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1832 (list (caddr x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1833 (list 'make-symbol
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1834 (format "--%s--" (car x)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1835 vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1836 (apply 'append '(setf)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1837 (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1838 (list (list 'symbol-value (caddr x)) (cadr x)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1839 vars))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1840 ebody))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1841
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1842 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1843 (defmacro lexical-let* (bindings &rest body)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
1844 "Like `let*', but lexically scoped.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1845 The main visible difference is that lambdas inside BODY will create
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1846 lexical closures as in Common Lisp."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1847 (if (null bindings) (cons 'progn body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1848 (setq bindings (reverse bindings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1849 (while bindings
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1850 (setq body (list (list* 'lexical-let (list (pop bindings)) body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1851 (car body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1852
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1853 (defun cl-defun-expander (func &rest rest)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1854 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1855 (list 'defalias (list 'quote func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1856 (list 'function (cons 'lambda rest)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1857 (list 'quote func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1858
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1859 ;;; Multiple values. We support full Common Lisp conventions here.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1860
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1861 ;;;###autoload
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1862 (defmacro multiple-value-bind (syms form &rest body)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1863 "Collect and bind multiple return values.
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1864
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1865 If FORM returns multiple values, each symbol in SYMS is bound to one of
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1866 them, in order, and BODY is executed. If FORM returns fewer multiple values
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1867 than there are SYMS, remaining SYMS are bound to nil. If FORM does
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1868 not return multiple values, it is treated as returning one multiple value.
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1869
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1870 Returns the value given by the last element of BODY."
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1871 (if (null syms)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1872 `(progn ,form ,@body)
5366
f00192e1cd49 Examining the result of #'length: `eql', not `=', it's better style & cheaper
Aidan Kehoe <kehoea@parhasard.net>
parents: 5356
diff changeset
1873 (if (eql 1 (length syms))
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1874 ;; Code written to deal with other "implementations" of multiple
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1875 ;; values may have a one-element SYMS.
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1876 `(let ((,(car syms) ,form))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1877 ,@body)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1878 (let ((temp (gensym)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1879 `(let* ((,temp (multiple-value-list-internal 0 ,(length syms) ,form))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1880 ,@(loop
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1881 for var in syms
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1882 collect `(,var (prog1 (car ,temp)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1883 (setq ,temp (cdr ,temp))))))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1884 ,@body)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1885
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1886 ;;;###autoload
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1887 (defmacro multiple-value-setq (syms form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1888 "Collect and set multiple values.
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1889
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1890 FORM should normally return multiple values; the first N values are stored
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1891 in the symbols in SYMS in turn. If FORM returns fewer than N values, the
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1892 remaining symbols have their values set to nil. FORM not returning multiple
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1893 values is treated as FORM returning one multiple value, with other elements
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1894 of SYMS initialized to nil.
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1895
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1896 Returns the first of the multiple values given by FORM."
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1897 (if (null syms)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1898 ;; Never return multiple values from multiple-value-setq:
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1899 (and form `(values ,form))
5366
f00192e1cd49 Examining the result of #'length: `eql', not `=', it's better style & cheaper
Aidan Kehoe <kehoea@parhasard.net>
parents: 5356
diff changeset
1900 (if (eql 1 (length syms))
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1901 `(setq ,(car syms) ,form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1902 (let ((temp (gensym)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1903 `(let* ((,temp (multiple-value-list-internal 0 ,(length syms) ,form)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1904 (setq ,@(loop
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1905 for sym in syms
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1906 nconc `(,sym (car-safe ,temp)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1907 ,temp (cdr-safe ,temp))))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1908 ,(car syms))))))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1909
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1910 ;;;###autoload
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1911 (defmacro multiple-value-list (form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1912 "Evaluate FORM and return a list of the multiple values it returned."
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1913 `(multiple-value-list-internal 0 multiple-values-limit ,form))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1914
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1915 ;;;###autoload
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1916 (defmacro nth-value (n form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1917 "Evaluate FORM and return the Nth multiple value it returned."
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1918 (if (integerp n)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1919 `(car (multiple-value-list-internal ,n ,(1+ n) ,form))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1920 (let ((temp (gensym)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1921 `(let ((,temp ,n))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1922 (car (multiple-value-list-internal ,temp (1+ ,temp) ,form))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1923
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1924 ;;; Declarations.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1925
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1926 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1927 (defmacro locally (&rest body) (cons 'progn body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1928 ;;;###autoload
5263
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1929 (defmacro the (type form)
5269
90a0084b3541 Rephrase the #'the docstring, make it nicer while byte-compiling.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5266
diff changeset
1930 "Assert that FORM gives a result of type TYPE, and return that result.
5263
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1931
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1932 TYPE is a Common Lisp type specifier.
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1933
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1934 If macro expansion of a `the' form happens during byte compilation, and the
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1935 byte compiler customization variable `byte-compile-delete-errors' is
5269
90a0084b3541 Rephrase the #'the docstring, make it nicer while byte-compiling.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5266
diff changeset
1936 non-nil, `the' is equivalent to FORM without any type checks."
5263
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1937 (if (cl-safe-expr-p form)
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1938 `(prog1 ,form (assert ,(cl-make-type-test form type) t))
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1939 (let ((saved (gensym)))
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1940 `(let ((,saved ,form))
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1941 (prog1 ,saved (assert ,(cl-make-type-test saved type) t))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1942
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1943 (defvar cl-proclaim-history t) ; for future compilers
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1944 (defvar cl-declare-stack t) ; for future compilers
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1945
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1946 (defun cl-do-proclaim (spec hist)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1947 (and hist (listp cl-proclaim-history) (push spec cl-proclaim-history))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1948 (cond ((eq (car-safe spec) 'special)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1949 (if (boundp 'byte-compile-bound-variables)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1950 (setq byte-compile-bound-variables
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
1951 (append
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1952 ;; XEmacs change
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
1953 (mapcar #'(lambda (v) (cons v byte-compile-global-bit))
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
1954 (cdr spec))
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
1955 byte-compile-bound-variables))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1956
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1957 ((eq (car-safe spec) 'inline)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1958 (while (setq spec (cdr spec))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1959 (or (memq (get (car spec) 'byte-optimizer)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1960 '(nil byte-compile-inline-expand))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1961 (error "%s already has a byte-optimizer, can't make it inline"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1962 (car spec)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1963 (put (car spec) 'byte-optimizer 'byte-compile-inline-expand)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1964
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1965 ((eq (car-safe spec) 'notinline)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1966 (while (setq spec (cdr spec))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1967 (if (eq (get (car spec) 'byte-optimizer)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1968 'byte-compile-inline-expand)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1969 (put (car spec) 'byte-optimizer nil))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1970
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1971 ((eq (car-safe spec) 'optimize)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1972 (let ((speed (assq (nth 1 (assq 'speed (cdr spec)))
446
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1973 '((0 . nil) (1 . t) (2 . t) (3 . t))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1974 (safety (assq (nth 1 (assq 'safety (cdr spec)))
446
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1975 '((0 . t) (1 . t) (2 . t) (3 . nil)))))
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1976 (when speed
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1977 (setq cl-optimize-speed (car speed)
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1978 byte-optimize (cdr speed)))
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1979 (when safety
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1980 (setq cl-optimize-safety (car safety)
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1981 byte-compile-delete-errors (cdr safety)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1982
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1983 ((and (eq (car-safe spec) 'warn) (boundp 'byte-compile-warnings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1984 (if (eq byte-compile-warnings t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1985 ;; XEmacs change
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1986 (setq byte-compile-warnings byte-compile-default-warnings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1987 (while (setq spec (cdr spec))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1988 (if (consp (car spec))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1989 (if (eq (cadar spec) 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1990 (setq byte-compile-warnings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1991 (delq (caar spec) byte-compile-warnings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1992 (setq byte-compile-warnings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1993 (adjoin (caar spec) byte-compile-warnings)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1994 nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1995
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1996 ;;; Process any proclamations made before cl-macs was loaded.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1997 (defvar cl-proclaims-deferred)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1998 (let ((p (reverse cl-proclaims-deferred)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1999 (while p (cl-do-proclaim (pop p) t))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2000 (setq cl-proclaims-deferred nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2001
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2002 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2003 (defmacro declare (&rest specs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2004 (if (cl-compiling-file)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2005 (while specs
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2006 (if (listp cl-declare-stack) (push (car specs) cl-declare-stack))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2007 (cl-do-proclaim (pop specs) nil)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2008 nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2009
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2010
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2011
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2012 ;;; Generalized variables.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2013
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2014 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2015 (defmacro define-setf-method (name arglist &rest body)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2016 "Define a `setf' method.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2017 This method shows how to handle `setf's to places of the form (NAME ARGLIST...).
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2018 The argument forms are bound according to ARGLIST, as if NAME were
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2019 going to be expanded as a macro, then the BODY forms are executed and must
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2020 return a list of five elements: a temporary-variables list, a value-forms
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2021 list, a store-variables list (of length one), a store-form, and an access-
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2022 form. See `defsetf' for a simpler way to define most setf-methods."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2023 (append '(eval-when (compile load eval))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2024 (if (stringp (car body))
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2025 (list (list 'put (list 'quote name) '(quote setf-documentation)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2026 (pop body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2027 (list (cl-transform-function-property
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2028 name 'setf-method (cons arglist body)))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2029 (defalias 'define-setf-expander 'define-setf-method)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2030
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2031 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2032 (defmacro defsetf (func arg1 &rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2033 "(defsetf NAME FUNC): define a `setf' method.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2034 This macro is an easy-to-use substitute for `define-setf-method' that works
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2035 well for simple place forms. In the simple `defsetf' form, `setf's of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2036 the form (setf (NAME ARGS...) VAL) are transformed to function or macro
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2037 calls of the form (FUNC ARGS... VAL). Example: (defsetf aref aset).
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2038 Alternate form: (defsetf NAME ARGLIST (STORE) BODY...).
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2039 Here, the above `setf' call is expanded by binding the argument forms ARGS
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2040 according to ARGLIST, binding the value form VAL to STORE, then executing
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2041 BODY, which must return a Lisp form that does the necessary `setf' operation.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2042 Actually, ARGLIST and STORE may be bound to temporary variables which are
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2043 introduced automatically to preserve proper execution order of the arguments.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2044 Example: (defsetf nth (n x) (v) (list 'setcar (list 'nthcdr n x) v))."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2045 (if (listp arg1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2046 (let* ((largs nil) (largsr nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2047 (temps nil) (tempsr nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2048 (restarg nil) (rest-temps nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2049 (store-var (car (prog1 (car args) (setq args (cdr args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2050 (store-temp (intern (format "--%s--temp--" store-var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2051 (lets1 nil) (lets2 nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2052 (docstr nil) (p arg1))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2053 (if (stringp (car args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2054 (setq docstr (prog1 (car args) (setq args (cdr args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2055 (while (and p (not (eq (car p) '&aux)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2056 (if (eq (car p) '&rest)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2057 (setq p (cdr p) restarg (car p))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2058 (or (memq (car p) '(&optional &key &allow-other-keys))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2059 (setq largs (cons (if (consp (car p)) (car (car p)) (car p))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2060 largs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2061 temps (cons (intern (format "--%s--temp--" (car largs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2062 temps))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2063 (setq p (cdr p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2064 (setq largs (nreverse largs) temps (nreverse temps))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2065 (if restarg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2066 (setq largsr (append largs (list restarg))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2067 rest-temps (intern (format "--%s--temp--" restarg))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2068 tempsr (append temps (list rest-temps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2069 (setq largsr largs tempsr temps))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2070 (let ((p1 largs) (p2 temps))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2071 (while p1
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2072 (setq lets1 (cons (list (car p2)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2073 (list 'gensym (format "--%s--" (car p1))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2074 lets1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2075 lets2 (cons (list (car p1) (car p2)) lets2)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2076 p1 (cdr p1) p2 (cdr p2))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2077 (if restarg (setq lets2 (cons (list restarg rest-temps) lets2)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2078 (append (list 'define-setf-method func arg1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2079 (and docstr (list docstr))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2080 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2081 (list 'let*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2082 (nreverse
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2083 (cons (list store-temp
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2084 (list 'gensym (format "--%s--" store-var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2085 (if restarg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2086 (append
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2087 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2088 (list rest-temps
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2089 (list 'mapcar '(quote gensym)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2090 restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2091 lets1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2092 lets1)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2093 (list 'list ; 'values
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2094 (cons (if restarg 'list* 'list) tempsr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2095 (cons (if restarg 'list* 'list) largsr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2096 (list 'list store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2097 (cons 'let*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2098 (cons (nreverse
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2099 (cons (list store-var store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2100 lets2))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2101 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2102 (cons (if restarg 'list* 'list)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2103 (cons (list 'quote func) tempsr)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2104 (list 'defsetf func '(&rest args) '(store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2105 (let ((call (list 'cons (list 'quote arg1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2106 '(append args (list store)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2107 (if (car args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2108 (list 'list '(quote progn) call 'store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2109 call)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2110
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2111 ;;; Some standard place types from Common Lisp.
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2112 (eval-when-compile (defvar ignored-arg)) ; XEmacs: warning suppression
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2113 (defsetf aref aset)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2114 (defsetf car setcar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2115 (defsetf cdr setcdr)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2116 (defsetf caar (x) (val) (list 'setcar (list 'car x) val))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2117 (defsetf cadr (x) (val) (list 'setcar (list 'cdr x) val))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2118 (defsetf cdar (x) (val) (list 'setcdr (list 'car x) val))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2119 (defsetf cddr (x) (val) (list 'setcdr (list 'cdr x) val))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2120 (defsetf elt (seq n) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2121 (list 'if (list 'listp seq) (list 'setcar (list 'nthcdr n seq) store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2122 (list 'aset seq n store)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2123 ;; XEmacs change: ignore the optional DEFAULT arguments
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2124 (defsetf get (x y &optional ignored-arg) (store) (list 'put x y store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2125 (defsetf get* (x y &optional ignored-arg) (store) (list 'put x y store))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2126 (defsetf gethash (x h &optional ignored-arg) (store) (list 'puthash x store h))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2127 (defsetf nth (n x) (store) (list 'setcar (list 'nthcdr n x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2128 (defsetf subseq (seq start &optional end) (new)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2129 (list 'progn (list 'replace seq new :start1 start :end1 end) new))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2130 (defsetf symbol-function fset)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2131 (defsetf symbol-plist setplist)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2132 (defsetf symbol-value set)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2133
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2134 ;;; Various car/cdr aliases. Note that `cadr' is handled specially.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2135 (defsetf first setcar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2136 (defsetf second (x) (store) (list 'setcar (list 'cdr x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2137 (defsetf third (x) (store) (list 'setcar (list 'cddr x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2138 (defsetf fourth (x) (store) (list 'setcar (list 'cdddr x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2139 (defsetf fifth (x) (store) (list 'setcar (list 'nthcdr 4 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2140 (defsetf sixth (x) (store) (list 'setcar (list 'nthcdr 5 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2141 (defsetf seventh (x) (store) (list 'setcar (list 'nthcdr 6 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2142 (defsetf eighth (x) (store) (list 'setcar (list 'nthcdr 7 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2143 (defsetf ninth (x) (store) (list 'setcar (list 'nthcdr 8 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2144 (defsetf tenth (x) (store) (list 'setcar (list 'nthcdr 9 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2145 (defsetf rest setcdr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2146
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2147 ;;; Some more Emacs-related place types.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2148 (defsetf buffer-file-name set-visited-file-name t)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2149 ;; XEmacs change: we do not need to wrap this in with-current-buffer
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2150 (defsetf buffer-modified-p set-buffer-modified-p t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2151 (defsetf buffer-name rename-buffer t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2152 (defsetf buffer-string () (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2153 (list 'progn '(erase-buffer) (list 'insert store)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2154 (defsetf buffer-substring cl-set-buffer-substring)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2155 (defsetf current-buffer set-buffer)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2156 (defsetf current-case-table set-case-table)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2157 (defsetf current-column move-to-column t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2158 (defsetf current-global-map use-global-map t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2159 (defsetf current-input-mode () (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2160 (list 'progn (list 'apply 'set-input-mode store) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2161 (defsetf current-local-map use-local-map t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2162 (defsetf current-window-configuration set-window-configuration t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2163 (defsetf default-file-modes set-default-file-modes t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2164 (defsetf default-value set-default)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2165 (defsetf documentation-property put)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2166 ;;(defsetf extent-data set-extent-data)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2167 (defsetf extent-face set-extent-face)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2168 (defsetf extent-priority set-extent-priority)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2169 ;; XEmacs addition
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2170 (defsetf extent-property (x y &optional ignored-arg) (arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2171 (list 'set-extent-property x y arg))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2172 (defsetf extent-end-position (ext) (store)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2173 `(progn (set-extent-endpoints ,ext (extent-start-position ,ext) ,store)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2174 ,store))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2175 (defsetf extent-start-position (ext) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2176 `(progn (set-extent-endpoints ,ext ,store (extent-end-position ,ext))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2177 ,store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2178 (defsetf face-background (f &optional s) (x) (list 'set-face-background f x s))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2179 (defsetf face-background-pixmap (f &optional s) (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2180 (list 'set-face-background-pixmap f x s))
5080
5502045ec510 The background-placement face property.
Didier Verna <didier@lrde.epita.fr>
parents: 5076
diff changeset
2181 (defsetf face-background-placement (f &optional s) (x)
5502045ec510 The background-placement face property.
Didier Verna <didier@lrde.epita.fr>
parents: 5076
diff changeset
2182 (list 'set-face-background-placement f x s))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2183 (defsetf face-font (f &optional s) (x) (list 'set-face-font f x s))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2184 (defsetf face-foreground (f &optional s) (x) (list 'set-face-foreground f x s))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2185 (defsetf face-underline-p (f &optional s) (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2186 (list 'set-face-underline-p f x s))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2187 (defsetf file-modes set-file-modes t)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2188 (defsetf frame-height (&optional f) (v)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2189 `(progn (set-frame-height ,f ,v) ,v))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2190 (defsetf frame-parameters modify-frame-parameters t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2191 (defsetf frame-visible-p cl-set-frame-visible-p)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2192 (defsetf frame-width (&optional f) (v)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2193 `(progn (set-frame-width ,f ,v) ,v))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2194 ;; XEmacs change: frame-properties instead of frame-parameters
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2195 (defsetf frame-properties (&optional f) (p)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2196 `(progn (set-frame-properties ,f ,p) ,p))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2197 (defsetf frame-property (f p &optional ignored-arg) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2198 `(progn (set-frame-property ,f ,v) ,p))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2199 ;; XEmacs addition
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2200 (defsetf current-frame-configuration set-frame-configuration)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2201
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2202 ;; XEmacs: new stuff
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2203 ;; Consoles
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2204 (defsetf selected-console select-console t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2205 (defsetf selected-device select-device t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2206 (defsetf device-baud-rate (&optional d) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2207 `(set-device-baud-rate ,d ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2208 ;; This setf method is a bad idea, because set-specifier *adds* a
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2209 ;; specification, rather than just setting it. The net effect is that
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2210 ;; it makes specifier-instance return VAL, but other things don't work
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2211 ;; as expected -- letf, to name one.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2212 ;(defsetf specifier-instance (spec &optional dom def nof) (val)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2213 ; `(set-specifier ,spec ,val ,dom))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2214
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2215 ;; Annotations
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2216 (defsetf annotation-glyph set-annotation-glyph)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2217 (defsetf annotation-down-glyph set-annotation-down-glyph)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2218 (defsetf annotation-face set-annotation-face)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2219 (defsetf annotation-layout set-annotation-layout)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2220 (defsetf annotation-data set-annotation-data)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2221 (defsetf annotation-action set-annotation-action)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2222 (defsetf annotation-menu set-annotation-menu)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2223 ;; Widget
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2224 (defsetf widget-get widget-put t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2225 (defsetf widget-value widget-value-set t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2226
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2227 ;; Misc
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2228 (defsetf recent-keys-ring-size set-recent-keys-ring-size)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2229 (defsetf symbol-value-in-buffer (s b &optional ignored-arg) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2230 `(with-current-buffer ,b (set ,s ,store)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2231 (defsetf symbol-value-in-console (s c &optional ignored-arg) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2232 `(letf (((selected-console) ,c))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2233 (set ,s ,store)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2234
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2235 (defsetf buffer-dedicated-frame (&optional b) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2236 `(set-buffer-dedicated-frame ,b ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2237 (defsetf console-type-image-conversion-list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2238 set-console-type-image-conversion-list)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2239 (defsetf default-toolbar-position set-default-toolbar-position)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2240 (defsetf device-class (&optional d) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2241 `(set-device-class ,d ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2242 (defsetf extent-begin-glyph set-extent-begin-glyph)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2243 (defsetf extent-begin-glyph-layout set-extent-begin-glyph-layout)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2244 (defsetf extent-end-glyph set-extent-end-glyph)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2245 (defsetf extent-end-glyph-layout set-extent-end-glyph-layout)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2246 (defsetf extent-keymap set-extent-keymap)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2247 (defsetf extent-parent set-extent-parent)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2248 (defsetf extent-properties set-extent-properties)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2249 ;; Avoid adding various face and glyph functions.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2250 (defsetf frame-selected-window (&optional f) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2251 `(set-frame-selected-window ,f ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2252 (defsetf glyph-image (glyph &optional domain) (i)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2253 (list 'set-glyph-image glyph i domain))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2254 (defsetf itimer-function set-itimer-function)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2255 (defsetf itimer-function-arguments set-itimer-function-arguments)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2256 (defsetf itimer-is-idle set-itimer-is-idle)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2257 (defsetf itimer-recorded-run-time set-itimer-recorded-run-time)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2258 (defsetf itimer-restart set-itimer-restart)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2259 (defsetf itimer-uses-arguments set-itimer-uses-arguments)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2260 (defsetf itimer-value set-itimer-value)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2261 (defsetf keymap-parents set-keymap-parents)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2262 (defsetf marker-insertion-type set-marker-insertion-type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2263 (defsetf mouse-pixel-position (&optional d) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2264 `(progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2265 (set-mouse-pixel-position ,d ,(car v) ,(car (cdr v)) ,(cdr (cdr v)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2266 ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2267 (defsetf trunc-stack-length set-trunc-stack-length)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2268 (defsetf trunc-stack-stack set-trunc-stack-stack)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2269 (defsetf undoable-stack-max set-undoable-stack-max)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2270 (defsetf weak-list-list set-weak-list-list)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2271 ;; End of new XEmacs stuff
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2272
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2273 (defsetf getenv setenv t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2274 (defsetf get-register set-register)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2275 (defsetf global-key-binding global-set-key)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2276 (defsetf keymap-parent set-keymap-parent)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2277 ;; XEmacs addition: more keymap-related setf forms
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2278 (defsetf keymap-name set-keymap-name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2279 (defsetf keymap-prompt set-keymap-prompt)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2280 (defsetf keymap-default-binding set-keymap-default-binding)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2281 (defsetf local-key-binding local-set-key)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2282 (defsetf mark set-mark t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2283 (defsetf mark-marker set-mark t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2284 (defsetf marker-position set-marker t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2285 (defsetf match-data store-match-data t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2286 (defsetf mouse-position (scr) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2287 (list 'set-mouse-position scr (list 'car store) (list 'cadr store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2288 (list 'cddr store)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2289 (defsetf overlay-get overlay-put)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2290 (defsetf overlay-start (ov) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2291 (list 'progn (list 'move-overlay ov store (list 'overlay-end ov)) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2292 (defsetf overlay-end (ov) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2293 (list 'progn (list 'move-overlay ov (list 'overlay-start ov) store) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2294 (defsetf point goto-char)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2295 (defsetf point-marker goto-char t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2296 (defsetf point-max () (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2297 (list 'progn (list 'narrow-to-region '(point-min) store) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2298 (defsetf point-min () (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2299 (list 'progn (list 'narrow-to-region store '(point-max)) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2300 (defsetf process-buffer set-process-buffer)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2301 (defsetf process-filter set-process-filter)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2302 (defsetf process-sentinel set-process-sentinel)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2303 ;;(defsetf process-get process-put)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2304 (defsetf read-mouse-position (scr) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2305 (list 'set-mouse-position scr (list 'car store) (list 'cdr store)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2306 ;;(defsetf screen-height set-screen-height t)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2307 ;;(defsetf screen-width set-screen-width t)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2308 (defsetf selected-window select-window)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2309 ;;(defsetf selected-screen select-screen)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2310 (defsetf selected-frame select-frame)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2311 (defsetf standard-case-table set-standard-case-table)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2312 (defsetf syntax-table set-syntax-table)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2313 (defsetf visited-file-modtime set-visited-file-modtime t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2314 (defsetf window-buffer set-window-buffer t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2315 (defsetf window-display-table set-window-display-table t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2316 (defsetf window-dedicated-p set-window-dedicated-p t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2317 (defsetf window-height (&optional window) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2318 `(progn (enlarge-window (- ,store (window-height)) nil ,window) ,store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2319 (defsetf window-hscroll set-window-hscroll)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2320 (defsetf window-point set-window-point)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2321 (defsetf window-start set-window-start)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2322 (defsetf window-width (&optional window) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2323 `(progn (enlarge-window (- ,store (window-width)) t ,window) ,store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2324 (defsetf x-get-cutbuffer x-store-cutbuffer t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2325 (defsetf x-get-cut-buffer x-store-cut-buffer t) ; groan.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2326 (defsetf x-get-secondary-selection x-own-secondary-selection t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2327 (defsetf x-get-selection x-own-selection t)
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
2328 (defsetf get-selection own-selection t)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2329
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2330 ;;; More complex setf-methods.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2331 ;;; These should take &environment arguments, but since full arglists aren't
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2332 ;;; available while compiling cl-macs, we fake it by referring to the global
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2333 ;;; variable cl-macro-environment directly.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2334
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2335 (define-setf-method apply (func arg1 &rest rest)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2336 (or (and (memq (car-safe func) '(quote function function*))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2337 (symbolp (car-safe (cdr-safe func))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2338 (error "First arg to apply in setf is not (function SYM): %s" func))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2339 (let* ((form (cons (nth 1 func) (cons arg1 rest)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2340 (method (get-setf-method form cl-macro-environment)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2341 (list (car method) (nth 1 method) (nth 2 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2342 (cl-setf-make-apply (nth 3 method) (cadr func) (car method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2343 (cl-setf-make-apply (nth 4 method) (cadr func) (car method)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2344
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2345 (defun cl-setf-make-apply (form func temps)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2346 (if (eq (car form) 'progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2347 (list* 'progn (cl-setf-make-apply (cadr form) func temps) (cddr form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2348 (or (equal (last form) (last temps))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2349 (error "%s is not suitable for use with setf-of-apply" func))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2350 (list* 'apply (list 'quote (car form)) (cdr form))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2351
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2352 (define-setf-method nthcdr (n place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2353 (let ((method (get-setf-method place cl-macro-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2354 (n-temp (gensym "--nthcdr-n--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2355 (store-temp (gensym "--nthcdr-store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2356 (list (cons n-temp (car method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2357 (cons n (nth 1 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2358 (list store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2359 (list 'let (list (list (car (nth 2 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2360 (list 'cl-set-nthcdr n-temp (nth 4 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2361 store-temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2362 (nth 3 method) store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2363 (list 'nthcdr n-temp (nth 4 method)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2364
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2365 (define-setf-method getf (place tag &optional def)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2366 (let ((method (get-setf-method place cl-macro-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2367 (tag-temp (gensym "--getf-tag--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2368 (def-temp (gensym "--getf-def--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2369 (store-temp (gensym "--getf-store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2370 (list (append (car method) (list tag-temp def-temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2371 (append (nth 1 method) (list tag def))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2372 (list store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2373 (list 'let (list (list (car (nth 2 method))
5285
99de5fd48e87 Tighten up Common Lisp compatibility, #'butlast, #'nbutlast, #'tailp, #'ldiff
Aidan Kehoe <kehoea@parhasard.net>
parents: 5269
diff changeset
2374 (list 'plist-put (nth 4 method)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2375 tag-temp store-temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2376 (nth 3 method) store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2377 (list 'getf (nth 4 method) tag-temp def-temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2378
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2379 (define-setf-method substring (place from &optional to)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2380 (let ((method (get-setf-method place cl-macro-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2381 (from-temp (gensym "--substring-from--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2382 (to-temp (gensym "--substring-to--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2383 (store-temp (gensym "--substring-store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2384 (list (append (car method) (list from-temp to-temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2385 (append (nth 1 method) (list from to))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2386 (list store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2387 (list 'let (list (list (car (nth 2 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2388 (list 'cl-set-substring (nth 4 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2389 from-temp to-temp store-temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2390 (nth 3 method) store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2391 (list 'substring (nth 4 method) from-temp to-temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2392
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2393 ;; XEmacs addition
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2394 (define-setf-method values (&rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2395 (let ((methods (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2396 (get-setf-method x cl-macro-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2397 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2398 (store-temp (gensym "--values-store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2399 (list (apply 'append (mapcar 'first methods))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2400 (apply 'append (mapcar 'second methods))
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2401 `((,store-temp
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2402 (multiple-value-list-internal 0 ,(if args (length args) 1))))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2403 (cons 'values
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2404 (mapcar #'(lambda (m)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2405 (cl-setf-do-store (cons (car (third m)) (fourth m))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2406 (list 'pop store-temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2407 methods))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2408 (cons 'list (mapcar 'fifth methods)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2409
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2410 ;;; Getting and optimizing setf-methods.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2411 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2412 (defun get-setf-method (place &optional env)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2413 "Return a list of five values describing the setf-method for PLACE.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2414 PLACE may be any Lisp form which can appear as the PLACE argument to
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2415 a macro like `setf' or `incf'."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2416 (if (symbolp place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2417 (let ((temp (gensym "--setf--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2418 (list nil nil (list temp) (list 'setq place temp) place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2419 (or (and (symbolp (car place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2420 (let* ((func (car place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2421 (name (symbol-name func))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2422 (method (get func 'setf-method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2423 (case-fold-search nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2424 (or (and method
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2425 (let ((cl-macro-environment env))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2426 (setq method (apply method (cdr place))))
5366
f00192e1cd49 Examining the result of #'length: `eql', not `=', it's better style & cheaper
Aidan Kehoe <kehoea@parhasard.net>
parents: 5356
diff changeset
2427 (if (and (consp method) (eql (length method) 5))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2428 method
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2429 (error "Setf-method for %s returns malformed method"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2430 func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2431 (and (save-match-data
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2432 (string-match "\\`c[ad][ad][ad]?[ad]?r\\'" name))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2433 (get-setf-method (compiler-macroexpand place)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2434 (and (eq func 'edebug-after)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2435 (get-setf-method (nth (1- (length place)) place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2436 env)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2437 (if (eq place (setq place (macroexpand place env)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2438 (if (and (symbolp (car place)) (fboundp (car place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2439 (symbolp (symbol-function (car place))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2440 (get-setf-method (cons (symbol-function (car place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2441 (cdr place)) env)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2442 (error "No setf-method known for %s" (car place)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2443 (get-setf-method place env)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2444
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2445 (defun cl-setf-do-modify (place opt-expr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2446 (let* ((method (get-setf-method place cl-macro-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2447 (temps (car method)) (values (nth 1 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2448 (lets nil) (subs nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2449 (optimize (and (not (eq opt-expr 'no-opt))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2450 (or (and (not (eq opt-expr 'unsafe))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2451 (cl-safe-expr-p opt-expr))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2452 (cl-setf-simple-store-p (car (nth 2 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2453 (nth 3 method)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2454 (simple (and optimize (consp place) (cl-simple-exprs-p (cdr place)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2455 (while values
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2456 (if (or simple (cl-const-expr-p (car values)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2457 (push (cons (pop temps) (pop values)) subs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2458 (push (list (pop temps) (pop values)) lets)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2459 (list (nreverse lets)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2460 (cons (car (nth 2 method)) (sublis subs (nth 3 method)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2461 (sublis subs (nth 4 method)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2462
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2463 (defun cl-setf-do-store (spec val)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2464 (let ((sym (car spec))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2465 (form (cdr spec)))
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2466 (if (consp sym)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2467 ;; XEmacs change, only used for implementing #'values at the moment.
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2468 (let* ((orig (copy-list sym))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2469 (intermediate (last orig))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2470 (circular-limit 32))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2471 (while (consp (car intermediate))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2472 (when (zerop circular-limit)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2473 (error 'circular-list "Form seems to contain loops"))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2474 (setq intermediate (last (car intermediate))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2475 circular-limit (1- circular-limit)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2476 (setcdr intermediate (list val))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2477 `(let (,orig)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2478 ,form))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2479 (if (or (cl-const-expr-p val)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2480 (and (cl-simple-expr-p val)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2481 (eq (cl-expr-contains form sym) 1))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2482 (cl-setf-simple-store-p sym form))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2483 (subst val sym form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2484 (list 'let (list (list sym val)) form)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2485
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2486 (defun cl-setf-simple-store-p (sym form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2487 (and (consp form) (eq (cl-expr-contains form sym) 1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2488 (eq (nth (1- (length form)) form) sym)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2489 (symbolp (car form)) (fboundp (car form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2490 (not (eq (car-safe (symbol-function (car form))) 'macro))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2491
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2492 ;;; The standard modify macros.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2493 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2494 (defmacro setf (&rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2495 "(setf PLACE VAL PLACE VAL ...): set each PLACE to the value of its VAL.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2496 This is a generalized version of `setq'; the PLACEs may be symbolic
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2497 references such as (car x) or (aref x i), as well as plain symbols.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2498 For example, (setf (cadar x) y) is equivalent to (setcar (cdar x) y).
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2499 The return value is the last VAL in the list."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2500 (if (cdr (cdr args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2501 (let ((sets nil))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2502 (while args (push (list 'setf (pop args) (pop args)) sets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2503 (cons 'progn (nreverse sets)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2504 (if (symbolp (car args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2505 (and args (cons 'setq args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2506 (let* ((method (cl-setf-do-modify (car args) (nth 1 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2507 (store (cl-setf-do-store (nth 1 method) (nth 1 args))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2508 (if (car method) (list 'let* (car method) store) store)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2509
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2510 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2511 (defmacro psetf (&rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2512 "(psetf PLACE VAL PLACE VAL ...): set PLACEs to the values VALs in parallel.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2513 This is like `setf', except that all VAL forms are evaluated (in order)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2514 before assigning any PLACEs to the corresponding values."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2515 (let ((p args) (simple t) (vars nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2516 (while p
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2517 (if (or (not (symbolp (car p))) (cl-expr-depends-p (nth 1 p) vars))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2518 (setq simple nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2519 (if (memq (car p) vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2520 (error "Destination duplicated in psetf: %s" (car p)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2521 (push (pop p) vars)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2522 (or p (error "Odd number of arguments to psetf"))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2523 (pop p))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2524 (if simple
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2525 (list 'progn (cons 'setf args) nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2526 (setq args (reverse args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2527 (let ((expr (list 'setf (cadr args) (car args))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2528 (while (setq args (cddr args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2529 (setq expr (list 'setf (cadr args) (list 'prog1 (car args) expr))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2530 (list 'progn expr nil)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2531
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2532 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2533 (defun cl-do-pop (place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2534 (if (cl-simple-expr-p place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2535 (list 'prog1 (list 'car place) (list 'setf place (list 'cdr place)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2536 (let* ((method (cl-setf-do-modify place t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2537 (temp (gensym "--pop--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2538 (list 'let*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2539 (append (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2540 (list (list temp (nth 2 method))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2541 (list 'prog1
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2542 (list 'car temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2543 (cl-setf-do-store (nth 1 method) (list 'cdr temp)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2544
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2545 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2546 (defmacro remf (place tag)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
2547 "Remove TAG from property list PLACE.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2548 PLACE may be a symbol, or any generalized variable allowed by `setf'.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2549 The form returns true if TAG was found and removed, nil otherwise."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2550 (let* ((method (cl-setf-do-modify place t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2551 (tag-temp (and (not (cl-const-expr-p tag)) (gensym "--remf-tag--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2552 (val-temp (and (not (cl-simple-expr-p place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2553 (gensym "--remf-place--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2554 (ttag (or tag-temp tag))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2555 (tval (or val-temp (nth 2 method))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2556 (list 'let*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2557 (append (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2558 (and val-temp (list (list val-temp (nth 2 method))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2559 (and tag-temp (list (list tag-temp tag))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2560 (list 'if (list 'eq ttag (list 'car tval))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2561 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2562 (cl-setf-do-store (nth 1 method) (list 'cddr tval))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2563 t)
5285
99de5fd48e87 Tighten up Common Lisp compatibility, #'butlast, #'nbutlast, #'tailp, #'ldiff
Aidan Kehoe <kehoea@parhasard.net>
parents: 5269
diff changeset
2564 (list 'plist-remprop tval ttag)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2565
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2566 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2567 (defmacro shiftf (place &rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2568 "(shiftf PLACE PLACE... VAL): shift left among PLACEs.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2569 Example: (shiftf A B C) sets A to B, B to C, and returns the old A.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2570 Each PLACE may be a symbol, or any generalized variable allowed by `setf'."
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2571 ;; XEmacs change: use iteration instead of recursion
5367
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
2572 (if (every #'symbolp (butlast (cons place args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2573 (list* 'prog1 place
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2574 (let ((sets nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2575 (while args
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2576 (push (list 'setq place (car args)) sets)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2577 (setq place (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2578 (nreverse sets)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2579 (let* ((places (reverse (cons place args)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2580 (form (pop places)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2581 (while places
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2582 (let ((method (cl-setf-do-modify (pop places) 'unsafe)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2583 (setq form (list 'let* (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2584 (list 'prog1 (nth 2 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2585 (cl-setf-do-store (nth 1 method) form))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2586 form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2587
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2588 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2589 (defmacro rotatef (&rest places)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2590 "Rotate left among PLACES.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2591 Example: (rotatef A B C) sets A to B, B to C, and C to A. It returns nil.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2592 Each PLACE may be a symbol, or any generalized variable allowed by `setf'."
5367
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
2593 (if (every #'symbolp places)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2594 (and (cdr places)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2595 (let ((sets nil)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2596 (first (car places)))
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2597 (while (cdr places)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2598 (setq sets (nconc sets (list (pop places) (car places)))))
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2599 (nconc (list 'psetf) sets (list (car places) first))))
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2600 (let* ((places (reverse places))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2601 (temp (gensym "--rotatef--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2602 (form temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2603 (while (cdr places)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2604 (let ((method (cl-setf-do-modify (pop places) 'unsafe)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2605 (setq form (list 'let* (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2606 (list 'prog1 (nth 2 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2607 (cl-setf-do-store (nth 1 method) form))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2608 (let ((method (cl-setf-do-modify (car places) 'unsafe)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2609 (list 'let* (append (car method) (list (list temp (nth 2 method))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2610 (cl-setf-do-store (nth 1 method) form) nil)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2611
4742
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2612 ;; This function is not in Common Lisp, and there are gaps in its structure and
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2613 ;; implementation that reflect that it was never well-specified. E.g. with
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2614 ;; setf, the question of whether a PLACE is bound or not and how to make it
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2615 ;; unbound doesn't arise, but we need some way of specifying that for letf to
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2616 ;; be sensible for gethash, symbol-value and so on; currently we just hard-code
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2617 ;; symbol-value, symbol-function and values (the latter is XEmacs work that
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2618 ;; I've just done) in the body of this function, and the following gives the
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2619 ;; wrong behaviour for gethash:
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2620 ;;
4820
e6dec75ded0e Use keywords, not ordinary symbols, in the structure syntax for hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4810
diff changeset
2621 ;; (setq my-hash-table #s(hash-table :test equal :data ())
4742
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2622 ;; print-gensym t)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2623 ;; => t
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2624 ;; (gethash "my-key" my-hash-table (gensym))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2625 ;; => #:G68010
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2626 ;; (letf (((gethash "my-key" my-hash-table) 4000))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2627 ;; (message "key value is %S" (gethash "my-key" my-hash-table)))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2628 ;; => "key value is 4000"
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2629 ;; (gethash "my-key" my-hash-table (gensym))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2630 ;; => nil ;; should be an uninterned symbol.
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2631 ;;
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2632 ;; Aidan Kehoe, Fr Nov 13 16:12:21 GMT 2009
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2633
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2634 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2635 (defmacro letf (bindings &rest body)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2636 "Temporarily bind to PLACEs.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2637 This is the analogue of `let', but with generalized variables (in the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2638 sense of `setf') for the PLACEs. Each PLACE is set to the corresponding
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2639 VALUE, then the BODY forms are executed. On exit, either normally or
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2640 because of a `throw' or error, the PLACEs are set back to their original
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2641 values. Note that this macro is *not* available in Common Lisp.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2642 As a special case, if `(PLACE)' is used instead of `(PLACE VALUE)',
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2643 the PLACE is not modified before executing BODY.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2644
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2645 arguments: (((PLACE VALUE) &rest BINDINGS) &body BODY)"
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2646 (if (and (not (cdr bindings)) (cdar bindings) (symbolp (caar bindings)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2647 (list* 'let bindings body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2648 (let ((lets nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2649 (rev (reverse bindings)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2650 (while rev
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2651 (let* ((place (if (symbolp (caar rev))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2652 (list 'symbol-value (list 'quote (caar rev)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2653 (caar rev)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2654 (value (cadar rev))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2655 (method (cl-setf-do-modify place 'no-opt))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2656 (save (gensym "--letf-save--"))
4742
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2657 (bound (and (memq (car place)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2658 '(symbol-value symbol-function values))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2659 (gensym "--letf-bound--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2660 (temp (and (not (cl-const-expr-p value)) (cdr bindings)
4742
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2661 (gensym "--letf-val--")))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2662 (syms (and (eq 'values (car place))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2663 (gensym "--letf-syms--")))
4783
e29fcfd8df5f Eliminate most core code byte-compile warnings.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4742
diff changeset
2664 (cursor (and syms (gensym "--letf-cursor--"))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2665 (setq lets (nconc (car method)
4742
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2666 (cond
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2667 (syms
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2668 `((,syms ',(loop
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2669 for sym in (cdr place)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2670 nconc (if (symbolp sym) (list sym))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2671 (,cursor ,syms)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2672 (,bound nil)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2673 (,save
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2674 (prog2
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2675 (while (consp ,cursor)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2676 (setq ,bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2677 (cons (and (boundp (car ,cursor))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2678 (symbol-value
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2679 (car ,cursor)))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2680 ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2681 ,cursor (cdr ,cursor)))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2682 ;; Just using ,bound as a temporary
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2683 ;; variable here, to initialise ,save:
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2684 (nreverse ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2685 ;; Now, really initialise ,bound:
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2686 (setq ,cursor ,syms
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2687 ,bound nil
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2688 ,bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2689 (progn (while (consp ,cursor)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2690 (setq ,bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2691 (cons
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2692 (boundp (car ,cursor))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2693 ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2694 ,cursor (cdr ,cursor)))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2695 (nreverse ,bound)))))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2696 (bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2697 (list (list bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2698 (list (if (eq (car place)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2699 'symbol-value)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2700 'boundp 'fboundp)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2701 (nth 1 (nth 2 method))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2702 (list save (list 'and bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2703 (nth 2 method)))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2704 (t
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2705 (list (list save (nth 2 method)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2706 (and temp (list (list temp value)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2707 lets)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2708 body (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2709 (list 'unwind-protect
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2710 (cons 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2711 (if (cdr (car rev))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2712 (cons (cl-setf-do-store (nth 1 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2713 (or temp value))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2714 body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2715 body))
4742
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2716 (cond
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2717 (syms
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2718 `(while (consp ,syms)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2719 (if (car ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2720 (set (car ,syms) (car ,save))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2721 (makunbound (car ,syms)))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2722 (setq ,syms (cdr ,syms)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2723 ,bound (cdr ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2724 ,save (cdr ,save))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2725 (bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2726 (list 'if bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2727 (cl-setf-do-store (nth 1 method) save)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2728 (list (if (eq (car place)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2729 'symbol-function)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2730 'fmakunbound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2731 'makunbound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2732 (nth 1 (nth 2 method)))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2733 (t
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2734 (cl-setf-do-store (nth 1 method) save)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2735 rev (cdr rev))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2736 (list* 'let* lets body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2737
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2738 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2739 (defmacro letf* (bindings &rest body)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2740 "Temporarily bind to PLACES.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2741 This is the analogue of `let*', but with generalized variables (in the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2742 sense of `setf') for the PLACEs. Each PLACE is set to the corresponding
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2743 VALUE, then the BODY forms are executed. On exit, either normally or
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2744 because of a `throw' or error, the PLACEs are set back to their original
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2745 values. Note that this macro is *not* available in Common Lisp.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2746 As a special case, if `(PLACE)' is used instead of `(PLACE VALUE)',
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2747 the PLACE is not modified before executing BODY.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2748
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2749 arguments: (((PLACE VALUE) &rest BINDINGS) &body BODY)"
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2750 (if (null bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2751 (cons 'progn body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2752 (setq bindings (reverse bindings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2753 (while bindings
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2754 (setq body (list (list* 'letf (list (pop bindings)) body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2755 (car body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2756
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2757 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2758 (defmacro callf (func place &rest args)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
2759 "Set PLACE to (FUNC PLACE ARGS...).
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2760 FUNC should be an unquoted function name. PLACE may be a symbol,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2761 or any generalized variable allowed by `setf'."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2762 (let* ((method (cl-setf-do-modify place (cons 'list args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2763 (rargs (cons (nth 2 method) args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2764 (list 'let* (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2765 (cl-setf-do-store (nth 1 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2766 (if (symbolp func) (cons func rargs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2767 (list* 'funcall (list 'function func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2768 rargs))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2769
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2770 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2771 (defmacro callf2 (func arg1 place &rest args)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
2772 "Set PLACE to (FUNC ARG1 PLACE ARGS...).
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2773 Like `callf', but PLACE is the second argument of FUNC, not the first."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2774 (if (and (cl-safe-expr-p arg1) (cl-simple-expr-p place) (symbolp func))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2775 (list 'setf place (list* func arg1 place args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2776 (let* ((method (cl-setf-do-modify place (cons 'list args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2777 (temp (and (not (cl-const-expr-p arg1)) (gensym "--arg1--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2778 (rargs (list* (or temp arg1) (nth 2 method) args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2779 (list 'let* (append (and temp (list (list temp arg1))) (car method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2780 (cl-setf-do-store (nth 1 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2781 (if (symbolp func) (cons func rargs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2782 (list* 'funcall (list 'function func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2783 rargs)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2784
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2785 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2786 (defmacro define-modify-macro (name arglist func &optional doc)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
2787 "Define a `setf'-like modify macro.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2788 If NAME is called, it combines its PLACE argument with the other arguments
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2789 from ARGLIST using FUNC: (define-modify-macro incf (&optional (n 1)) +)"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2790 (if (memq '&key arglist) (error "&key not allowed in define-modify-macro"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2791 (let ((place (gensym "--place--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2792 (list 'defmacro* name (cons place arglist) doc
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2793 (list* (if (memq '&rest arglist) 'list* 'list)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2794 '(quote callf) (list 'quote func) place
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2795 (cl-arglist-args arglist)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2796
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2797
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2798 ;;; Structures.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2799
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2800 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2801 (defmacro defstruct (struct &rest descs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2802 "(defstruct (NAME OPTIONS...) (SLOT SLOT-OPTS...)...): define a struct type.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2803 This macro defines a new Lisp data type called NAME, which contains data
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2804 stored in SLOTs. This defines a `make-NAME' constructor, a `copy-NAME'
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2805 copier, a `NAME-p' predicate, and setf-able `NAME-SLOT' accessors."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2806 (let* ((name (if (consp struct) (car struct) struct))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2807 (opts (cdr-safe struct))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2808 (slots nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2809 (defaults nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2810 (conc-name (concat (symbol-name name) "-"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2811 (constructor (intern (format "make-%s" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2812 (constrs nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2813 (copier (intern (format "copy-%s" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2814 (predicate (intern (format "%s-p" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2815 (print-func nil) (print-auto nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2816 (safety (if (cl-compiling-file) cl-optimize-safety 3))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2817 (include nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2818 (tag (intern (format "cl-struct-%s" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2819 (tag-symbol (intern (format "cl-struct-%s-tags" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2820 (include-descs nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2821 (side-eff nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2822 (type nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2823 (named nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2824 (forms nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2825 pred-form pred-check)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2826 (if (stringp (car descs))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2827 (push (list 'put (list 'quote name) '(quote structure-documentation)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2828 (pop descs)) forms))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2829 (setq descs (cons '(cl-tag-slot)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2830 (mapcar #'(lambda (x) (if (consp x) x (list x)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2831 descs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2832 (while opts
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2833 (let ((opt (if (consp (car opts)) (caar opts) (car opts)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2834 (args (cdr-safe (pop opts))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2835 (cond ((eq opt :conc-name)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2836 (if args
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2837 (setq conc-name (if (car args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2838 (symbol-name (car args)) ""))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2839 ((eq opt :constructor)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2840 (if (cdr args)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2841 (push args constrs)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2842 (if args (setq constructor (car args)))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2843 ((eq opt :copier)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2844 (if args (setq copier (car args))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2845 ((eq opt :predicate)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2846 (if args (setq predicate (car args))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2847 ((eq opt :include)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2848 (setq include (car args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2849 include-descs (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2850 (if (consp x) x (list x)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2851 (cdr args))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2852 ((eq opt :print-function)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2853 (setq print-func (car args)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2854 ((eq opt :type)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2855 (setq type (car args)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2856 ((eq opt :named)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2857 (setq named t))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2858 ((eq opt :initial-offset)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2859 (setq descs (nconc (make-list (car args) '(cl-skip-slot))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2860 descs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2861 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2862 (error "Slot option %s unrecognized" opt)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2863 (if print-func
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2864 (setq print-func (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2865 (list 'funcall (list 'function print-func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2866 'cl-x 'cl-s 'cl-n) t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2867 (or type (and include (not (get include 'cl-struct-print)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2868 (setq print-auto t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2869 print-func (and (or (not (or include type)) (null print-func))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2870 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2871 (list 'princ (format "#S(%s" name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2872 'cl-s))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2873 (if include
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2874 (let ((inc-type (get include 'cl-struct-type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2875 (old-descs (get include 'cl-struct-slots)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2876 (or inc-type (error "%s is not a struct name" include))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2877 (and type (not (eq (car inc-type) type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2878 (error ":type disagrees with :include for %s" name))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2879 (while include-descs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2880 (setcar (memq (or (assq (caar include-descs) old-descs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2881 (error "No slot %s in included struct %s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2882 (caar include-descs) include))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2883 old-descs)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2884 (pop include-descs)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2885 (setq descs (append old-descs (delq (assq 'cl-tag-slot descs) descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2886 type (car inc-type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2887 named (assq 'cl-tag-slot descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2888 (if (cadr inc-type) (setq tag name named t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2889 (let ((incl include))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2890 (while incl
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2891 (push (list 'pushnew (list 'quote tag)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2892 (intern (format "cl-struct-%s-tags" incl)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2893 forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2894 (setq incl (get incl 'cl-struct-include)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2895 (if type
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2896 (progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2897 (or (memq type '(vector list))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2898 (error "Illegal :type specifier: %s" type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2899 (if named (setq tag name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2900 (setq type 'vector named 'true)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2901 (or named (setq descs (delq (assq 'cl-tag-slot descs) descs)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2902 (push (list 'defvar tag-symbol) forms)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2903 (setq pred-form (and named
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2904 (let ((pos (- (length descs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2905 (length (memq (assq 'cl-tag-slot descs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2906 descs)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2907 (if (eq type 'vector)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2908 (list 'and '(vectorp cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2909 (list '>= '(length cl-x) (length descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2910 (list 'memq (list 'aref 'cl-x pos)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2911 tag-symbol))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2912 (if (= pos 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2913 (list 'memq '(car-safe cl-x) tag-symbol)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2914 (list 'and '(consp cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2915 (list 'memq (list 'nth pos 'cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2916 tag-symbol))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2917 pred-check (and pred-form (> safety 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2918 (if (and (eq (caadr pred-form) 'vectorp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2919 (= safety 1))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2920 (cons 'and (cdddr pred-form)) pred-form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2921 (let ((pos 0) (descp descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2922 (while descp
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2923 (let* ((desc (pop descp))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2924 (slot (car desc)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2925 (if (memq slot '(cl-tag-slot cl-skip-slot))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2926 (progn
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2927 (push nil slots)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2928 (push (and (eq slot 'cl-tag-slot) (list 'quote tag))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2929 defaults))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2930 (if (assq slot descp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2931 (error "Duplicate slots named %s in %s" slot name))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2932 (let ((accessor (intern (format "%s%s" conc-name slot))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2933 (push slot slots)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2934 (push (nth 1 desc) defaults)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2935 (push (list*
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2936 'defsubst* accessor '(cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2937 (append
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2938 (and pred-check
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2939 (list (list 'or pred-check
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2940 (list 'error
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2941 (format "%s accessing a non-%s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2942 accessor name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2943 'cl-x))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2944 (list (if (eq type 'vector) (list 'aref 'cl-x pos)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2945 (if (= pos 0) '(car cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2946 (list 'nth pos 'cl-x)))))) forms)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2947 (push (cons accessor t) side-eff)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2948 (push (list 'define-setf-method accessor '(cl-x)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2949 (if (cadr (memq :read-only (cddr desc)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2950 (list 'error (format "%s is a read-only slot"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2951 accessor))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2952 (list 'cl-struct-setf-expander 'cl-x
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2953 (list 'quote name) (list 'quote accessor)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2954 (and pred-check (list 'quote pred-check))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2955 pos)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2956 forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2957 (if print-auto
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2958 (nconc print-func
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2959 (list (list 'princ (format " %s" slot) 'cl-s)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2960 (list 'prin1 (list accessor 'cl-x) 'cl-s)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2961 (setq pos (1+ pos))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2962 (setq slots (nreverse slots)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2963 defaults (nreverse defaults))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2964 (and predicate pred-form
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2965 (progn (push (list 'defsubst* predicate '(cl-x)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2966 (if (eq (car pred-form) 'and)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2967 (append pred-form '(t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2968 (list 'and pred-form t))) forms)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2969 (push (cons predicate 'error-free) side-eff)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2970 (and copier
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2971 (progn (push (list 'defun copier '(x) '(copy-sequence x)) forms)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2972 (push (cons copier t) side-eff)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2973 (if constructor
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2974 (push (list constructor
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2975 (cons '&key (delq nil (copy-sequence slots))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2976 constrs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2977 (while constrs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2978 (let* ((name (caar constrs))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2979 (args (cadr (pop constrs)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2980 (anames (cl-arglist-args args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2981 (make (mapcar* #'(lambda (s d) (if (memq s anames) s d))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2982 slots defaults)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2983 (push (list 'defsubst* name
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2984 (list* '&cl-defs (list 'quote (cons nil descs)) args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2985 (cons type make)) forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2986 (if (cl-safe-expr-p (cons 'progn (mapcar 'second descs)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2987 (push (cons name t) side-eff))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2988 (if print-auto (nconc print-func (list '(princ ")" cl-s) t)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2989 (if print-func
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2990 (push (list 'push
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2991 (list 'function
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2992 (list 'lambda '(cl-x cl-s cl-n)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2993 (list 'and pred-form print-func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2994 'custom-print-functions) forms))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2995 (push (list 'setq tag-symbol (list 'list (list 'quote tag))) forms)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2996 (push (list* 'eval-when '(compile load eval)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2997 (list 'put (list 'quote name) '(quote cl-struct-slots)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2998 (list 'quote descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2999 (list 'put (list 'quote name) '(quote cl-struct-type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3000 (list 'quote (list type (eq named t))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3001 (list 'put (list 'quote name) '(quote cl-struct-include)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3002 (list 'quote include))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3003 (list 'put (list 'quote name) '(quote cl-struct-print)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3004 print-auto)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3005 (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3006 (list 'put (list 'quote (car x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3007 '(quote side-effect-free)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3008 (list 'quote (cdr x))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3009 side-eff))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3010 forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3011 (cons 'progn (nreverse (cons (list 'quote name) forms)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3012
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3013 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3014 (defun cl-struct-setf-expander (x name accessor pred-form pos)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3015 (let* ((temp (gensym "--x--")) (store (gensym "--store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3016 (list (list temp) (list x) (list store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3017 (append '(progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3018 (and pred-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3019 (list (list 'or (subst temp 'cl-x pred-form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3020 (list 'error
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3021 (format
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3022 "%s storing a non-%s" accessor name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3023 temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3024 (list (if (eq (car (get name 'cl-struct-type)) 'vector)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3025 (list 'aset temp pos store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3026 (list 'setcar
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3027 (if (<= pos 5)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3028 (let ((xx temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3029 (while (>= (setq pos (1- pos)) 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3030 (setq xx (list 'cdr xx)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3031 xx)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3032 (list 'nthcdr pos temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3033 store))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3034 (list accessor temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3035
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3036
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3037 ;;; Types and assertions.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3038
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3039 ;;;###autoload
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3040 (defmacro deftype (name arglist &rest body)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
3041 "Define NAME as a new data type.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3042 The type name can then be used in `typecase', `check-type', etc."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3043 (list 'eval-when '(compile load eval)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3044 (cl-transform-function-property
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3045 name 'cl-deftype-handler (cons (list* '&cl-defs ''('*) arglist) body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3046
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3047 (defun cl-make-type-test (val type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3048 (if (symbolp type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3049 (cond ((get type 'cl-deftype-handler)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3050 (cl-make-type-test val (funcall (get type 'cl-deftype-handler))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3051 ((memq type '(nil t)) type)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3052 ((eq type 'null) `(null ,val))
4885
6772ce4d982b Fix hash tables, #'member*, #'assoc*, #'eql compiler macros if bignums
Aidan Kehoe <kehoea@parhasard.net>
parents: 4820
diff changeset
3053 ((eq type 'float) `(floatp ,val))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3054 ((eq type 'real) `(numberp ,val))
4885
6772ce4d982b Fix hash tables, #'member*, #'assoc*, #'eql compiler macros if bignums
Aidan Kehoe <kehoea@parhasard.net>
parents: 4820
diff changeset
3055 ((eq type 'fixnum) `(fixnump ,val))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3056 ;; XEmacs change: we do not have char-valid-p
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3057 ((memq type '(character string-char)) `(characterp ,val))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3058 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3059 (let* ((name (symbol-name type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3060 (namep (intern (concat name "p"))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3061 (if (fboundp namep) (list namep val)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3062 (list (intern (concat name "-p")) val)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3063 (cond ((get (car type) 'cl-deftype-handler)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3064 (cl-make-type-test val (apply (get (car type) 'cl-deftype-handler)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3065 (cdr type))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3066 ((memq (car-safe type) '(integer float real number))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3067 (delq t (list 'and (cl-make-type-test val (car type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3068 (if (memq (cadr type) '(* nil)) t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3069 (if (consp (cadr type)) (list '> val (caadr type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3070 (list '>= val (cadr type))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3071 (if (memq (caddr type) '(* nil)) t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3072 (if (consp (caddr type)) (list '< val (caaddr type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3073 (list '<= val (caddr type)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3074 ((memq (car-safe type) '(and or not))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3075 (cons (car type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3076 (mapcar #'(lambda (x) (cl-make-type-test val x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3077 (cdr type))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3078 ((memq (car-safe type) '(member member*))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3079 (list 'and (list 'member* val (list 'quote (cdr type))) t))
5305
09fed7053634 Handle slightly more complex type specifications, #'coerce, #'typep.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5301
diff changeset
3080 ((eq (car-safe type) 'eql)
09fed7053634 Handle slightly more complex type specifications, #'coerce, #'typep.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5301
diff changeset
3081 (list 'eql (cadr type) val))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3082 ((eq (car-safe type) 'satisfies) (list (cadr type) val))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3083 (t (error "Bad type spec: %s" type)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3084
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3085 ;;;###autoload
444
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 442
diff changeset
3086 (defun typep (object type) ; See compiler macro below.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3087 "Check that OBJECT is of type TYPE.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3088 TYPE is a Common Lisp-style type specifier."
444
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 442
diff changeset
3089 (eval (cl-make-type-test 'object type)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3090
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3091 ;;;###autoload
446
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
3092 (defmacro check-type (place type &optional string)
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
3093 "Verify that PLACE is of type TYPE; signal a continuable error if not.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3094 STRING is an optional description of the desired type."
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3095 (and (or (not (cl-compiling-file))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3096 (< cl-optimize-speed 3) (= cl-optimize-safety 3))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3097 (let* ((temp (if (cl-simple-expr-p place 3) place (gensym)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3098 (test (cl-make-type-test temp type))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3099 (signal-error `(signal 'wrong-type-argument
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3100 ,(list 'list (or string (list 'quote type))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3101 temp (list 'quote place))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3102 (body
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3103 (condition-case nil
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3104 `(while (not ,test)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3105 ,(macroexpand `(setf ,place ,signal-error)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3106 (error
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3107 `(if ,test (progn ,signal-error nil))))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3108 (if (eq temp place) `(progn ,body nil)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3109 `(let ((,temp ,place)) ,body nil)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3110
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3111 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3112 (defmacro assert (form &optional show-args string &rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3113 "Verify that FORM returns non-nil; signal an error if not.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3114 Second arg SHOW-ARGS means to include arguments of FORM in message.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3115 Other args STRING and ARGS... are arguments to be passed to `error'.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3116 They are not evaluated unless the assertion fails. If STRING is
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3117 omitted, a default message listing FORM itself is used."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3118 (and (or (not (cl-compiling-file))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3119 (< cl-optimize-speed 3) (= cl-optimize-safety 3))
5367
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
3120 (let ((sargs (and show-args (remove-if #'cl-const-expr-p (cdr form)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3121 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3122 (list 'or form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3123 (if string
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3124 (list* 'error string (append sargs args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3125 (list 'signal '(quote cl-assertion-failed)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3126 (list* 'list (list 'quote form) sargs))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3127 nil))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3128
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3129 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3130 (defmacro ignore-errors (&rest body)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3131 "Execute BODY; if an error occurs, return nil.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3132 Otherwise, return result of last form in BODY."
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3133 `(condition-case nil (progn ,@body) (error nil)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3134
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3135 ;; XEmacs addition
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3136 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3137 (defmacro ignore-file-errors (&rest body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3138 "Execute FORMS; if an error of type `file-error' occurs, return nil.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3139 Otherwise, return result of last FORM."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3140 `(condition-case nil (progn ,@body) (file-error nil)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3141
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3142
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3143 ;;; Compiler macros.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3144
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3145 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3146 (defmacro define-compiler-macro (func args &rest body)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
3147 "Define a compiler-only macro.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3148 This is like `defmacro', but macro expansion occurs only if the call to
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3149 FUNC is compiled (i.e., not interpreted). Compiler macros should be used
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3150 for optimizing the way calls to FUNC are compiled; the form returned by
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3151 BODY should do the same thing as a call to the normal function called
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3152 FUNC, though possibly more efficiently. Note that, like regular macros,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3153 compiler macros are expanded repeatedly until no further expansions are
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3154 possible. Unlike regular macros, BODY can decide to \"punt\" and leave the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3155 original function call alone by declaring an initial `&whole foo' parameter
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3156 and then returning foo."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3157 (let ((p (if (listp args) args (list '&rest args))) (res nil))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3158 (while (consp p) (push (pop p) res))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3159 (setq args (nconc (nreverse res) (and p (list '&rest p)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3160 (list 'eval-when '(compile load eval)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3161 (cl-transform-function-property
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3162 func 'cl-compiler-macro
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3163 (cons (if (memq '&whole args) (delq '&whole args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3164 (cons '--cl-whole-arg-- args)) body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3165 (list 'or (list 'get (list 'quote func) '(quote byte-compile))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3166 (list 'put (list 'quote func) '(quote byte-compile)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3167 '(quote cl-byte-compile-compiler-macro)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3168
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3169 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3170 (defun compiler-macroexpand (form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3171 (while
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3172 (let ((func (car-safe form)) (handler nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3173 (while (and (symbolp func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3174 (not (setq handler (get func 'cl-compiler-macro)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3175 (fboundp func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3176 (or (not (eq (car-safe (symbol-function func)) 'autoload))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3177 (load (nth 1 (symbol-function func)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3178 (setq func (symbol-function func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3179 (and handler
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3180 (not (eq form (setq form (apply handler form (cdr form))))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3181 form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3182
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3183 (defun cl-byte-compile-compiler-macro (form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3184 (if (eq form (setq form (compiler-macroexpand form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3185 (byte-compile-normal-call form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3186 (byte-compile-form form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3187
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3188 (defmacro defsubst* (name arglist &optional docstring &rest body)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3189 "Define NAME as a function.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3190 Like `defun', except the function is automatically declared `inline',
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3191 ARGLIST allows full Common Lisp conventions, and BODY is implicitly
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3192 surrounded by (block NAME ...)."
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3193 (let* ((argns (cl-arglist-args arglist)) (p argns)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3194 (exec-body (if (or (stringp docstring) (null docstring))
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3195 body
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3196 (cons docstring body)))
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3197 (pbody (cons 'progn exec-body))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3198 (unsafe (not (cl-safe-expr-p pbody))))
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3199 (while (and p (eq (cl-expr-contains arglist (car p)) 1)) (pop p))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3200 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3201 (if p nil ; give up if defaults refer to earlier args
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3202 (list 'define-compiler-macro name
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3203 (if (memq '&key arglist)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3204 (list* '&whole 'cl-whole '&cl-quote arglist)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3205 (cons '&cl-quote arglist))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3206 (list* 'cl-defsubst-expand (list 'quote argns)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3207 (list 'quote (list* 'block name exec-body))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3208 (not (or unsafe (cl-expr-access-order pbody argns)))
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3209 (and (memq '&key arglist) 'cl-whole) unsafe argns)))
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3210 (list* 'defun* name arglist docstring body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3211
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3212 (defun cl-defsubst-expand (argns body simple whole unsafe &rest argvs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3213 (if (and whole (not (cl-safe-expr-p (cons 'progn argvs)))) whole
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3214 (if (cl-simple-exprs-p argvs) (setq simple t))
5367
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
3215 (let ((lets (mapcan #'(lambda (argn argv)
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
3216 (if (or simple (cl-const-expr-p argv))
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
3217 (progn (setq body (subst argv argn body))
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
3218 (and unsafe (list (list argn argv))))
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
3219 (list (list argn argv))))
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
3220 argns argvs)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3221 (if lets (list 'let lets body) body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3222
5379
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3223 ;; When a 64-bit build is byte-compiling code, some of its native fixnums
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3224 ;; will not be represented as fixnums if the byte-compiled code is read by
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3225 ;; the Lisp reader in a 32-bit build. So in that case we need to check the
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3226 ;; range of fixnums as well as their types. XEmacs doesn't support machines
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3227 ;; with word size less than 32, so it's OK to have that as the minimum.
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3228 (macrolet
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3229 ((most-negative-fixnum-on-32-bit-machines () (lognot (1- (lsh 1 30))))
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3230 (most-positive-fixnum-on-32-bit-machines () (lsh 1 30)))
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3231 (defun cl-non-fixnum-number-p (object)
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3232 "Return t if OBJECT is a number not guaranteed to be immediate."
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3233 (and (numberp object)
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3234 (or (not (fixnump object))
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3235 (not (<= (most-negative-fixnum-on-32-bit-machines)
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3236 object
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3237 (most-positive-fixnum-on-32-bit-machines)))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3238
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3239 ;;; Compile-time optimizations for some functions defined in this package.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3240 ;;; Note that cl.el arranges to force cl-macs to be loaded at compile-time,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3241 ;;; mainly to make sure these macros will be present.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3242
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3243 (define-compiler-macro eql (&whole form a b)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3244 (cond ((eq (cl-const-expr-p a) t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3245 (let ((val (cl-const-expr-val a)))
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3246 (if (cl-non-fixnum-number-p val)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3247 (list 'equal a b)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3248 (list 'eq a b))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3249 ((eq (cl-const-expr-p b) t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3250 (let ((val (cl-const-expr-val b)))
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3251 (if (cl-non-fixnum-number-p val)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3252 (list 'equal a b)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3253 (list 'eq a b))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3254 (t form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3255
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3256 (macrolet
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3257 ((define-star-compiler-macros (&rest macros)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3258 "For `member*', `assoc*' and `rassoc*' with constant ITEM or
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3259 :test arguments, use the versions with explicit tests if that makes sense."
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3260 (list*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3261 'progn
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3262 (mapcar
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3263 (function*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3264 (lambda ((star-function eq-function equal-function))
5329
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3265 `(define-compiler-macro ,star-function (&whole form &rest keys)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3266 (if (< (length form) 3)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3267 form
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3268 (condition-case nil
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3269 (symbol-macrolet ((not-constant '#:not-constant))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3270 (let* ((item (pop keys))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3271 (list (pop keys))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3272 (test-expr (plist-get keys :test ''eql))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3273 (test (cl-const-expr-val test-expr not-constant))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3274 (item-val (cl-const-expr-val item not-constant))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3275 (list-val (cl-const-expr-val list not-constant)))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3276 (if (and keys (not (and (eq :test (car keys))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3277 (eql 2 (length keys)))))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3278 form
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3279 (cond ((eq test 'eq) `(,',eq-function ,item ,list))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3280 ((eq test 'equal)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3281 `(,',equal-function ,item ,list))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3282 ((and (eq test 'eql)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3283 (not (eq not-constant item-val)))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3284 (if (cl-non-fixnum-number-p item-val)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3285 `(,',equal-function ,item ,list)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3286 `(,',eq-function ,item ,list)))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3287 ((and (eq test 'eql) (not (eq not-constant
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3288 list-val)))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3289 (if (some 'cl-non-fixnum-number-p list-val)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3290 `(,',equal-function ,item ,list)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3291 ;; This compiler macro used to limit
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3292 ;; calls to ,,eq-function to lists where
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3293 ;; all elements were either fixnums or
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3294 ;; symbols. There's no reason to do this.
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3295 `(,',eq-function ,item ,list)))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3296 ;; This is a hilariously specific case; see
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3297 ;; add-to-list in subr.el.
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3298 ((and (eq test not-constant)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3299 (eq 'or (car-safe test-expr))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3300 (eql 3 (length test-expr))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3301 (every #'cl-safe-expr-p (cdr form))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3302 `(if ,(second test-expr)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3303 (,',star-function ,item ,list :test
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3304 ,(second test-expr))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3305 (,',star-function
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3306 ,item ,list :test
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3307 ,(third test-expr)))))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3308 (t form)))))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3309 ;; No need to warn about a malformed property list,
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3310 ;; #'byte-compile-normal-call will do that for us.
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3311 (malformed-property-list form))))))
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3312 macros))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3313 (define-star-compiler-macros
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3314 (member* memq member)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3315 (assoc* assq assoc)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3316 (rassoc* rassq rassoc)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3317
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3318 (define-compiler-macro adjoin (&whole form a list &rest keys)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3319 (if (and (cl-simple-expr-p a) (cl-simple-expr-p list)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3320 (not (memq :key keys)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3321 (list 'if (list* 'member* a list keys) list (list 'cons a list))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3322 form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3323
5338
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3324 (define-compiler-macro delete (&whole form &rest args)
5346
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3325 (if (eql 3 (length form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3326 (symbol-macrolet ((not-constant '#:not-constant))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3327 (let ((cl-const-expr-val (cl-const-expr-val (nth 1 form) not-constant)))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3328 (if (and (cdr form) (not (eq not-constant cl-const-expr-val))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3329 (or (symbolp cl-const-expr-val) (fixnump cl-const-expr-val)
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3330 (characterp cl-const-expr-val)))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3331 (cons 'delete* (cdr form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3332 `(delete* ,@(cdr form) :test #'equal))))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3333 form))
5338
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3334
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3335 (define-compiler-macro delq (&whole form &rest args)
5346
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3336 (if (eql 3 (length form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3337 (symbol-macrolet
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3338 ((not-constant '#:not-constant))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3339 (let ((cl-const-expr-val (cl-const-expr-val (nth 1 form) not-constant)))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3340 (if (and (cdr form) (not (eq not-constant cl-const-expr-val))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3341 (not (cl-non-fixnum-number-p cl-const-expr-val)))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3342 (cons 'delete* (cdr form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3343 `(delete* ,@(cdr form) :test #'eq))))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3344 form))
5338
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3345
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3346 (define-compiler-macro remove (&whole form &rest args)
5346
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3347 (if (eql 3 (length form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3348 (symbol-macrolet
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3349 ((not-constant '#:not-constant))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3350 (let ((cl-const-expr-val (cl-const-expr-val (nth 1 form) not-constant)))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3351 (if (and (cdr form) (not (eq not-constant cl-const-expr-val))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3352 (or (symbolp cl-const-expr-val) (fixnump cl-const-expr-val)
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3353 (characterp cl-const-expr-val)))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3354 (cons 'remove* (cdr form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3355 `(remove* ,@(cdr form) :test #'equal))))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3356 form))
5338
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3357
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3358 (define-compiler-macro remq (&whole form &rest args)
5346
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3359 (if (eql 3 (length form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3360 (symbol-macrolet
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3361 ((not-constant '#:not-constant))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3362 (let ((cl-const-expr-val (cl-const-expr-val (nth 1 form) not-constant)))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3363 (if (and (cdr form) (not (eq not-constant cl-const-expr-val))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3364 (not (cl-non-fixnum-number-p cl-const-expr-val)))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3365 (cons 'remove* (cdr form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3366 `(remove* ,@(cdr form) :test #'eq))))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3367 form))
5338
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3368
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3369 (macrolet
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3370 ((define-foo-if-compiler-macros (&rest alist)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3371 "Avoid the funcall, variable binding and keyword parsing overhead
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3372 for the FOO-IF and FOO-IF-NOT functions, transforming to forms using the
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3373 non-standard :if and :if-not keywords at compile time."
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3374 (cons
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3375 'progn
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3376 (mapcar
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3377 (function*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3378 (lambda ((function-if . function))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3379 (let ((keyword (if (equal (substring (symbol-name function-if) -3)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3380 "not")
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3381 :if-not
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3382 :if)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3383 `(define-compiler-macro ,function-if (&whole form &rest args)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3384 (if (and (nthcdr 2 form)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3385 (or (consp (cl-const-expr-val (second form)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3386 (cl-safe-expr-p (second form))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3387 ;; It doesn't matter what the second argument is, it's
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3388 ;; ignored by FUNCTION. We know that the symbol
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3389 ;; FUNCTION is in the constants vector, so use it.
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3390 `(,',function ',',function ,(third form) ,,keyword
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3391 ,(second form) ,@(nthcdr 3 form))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3392 form)))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3393 alist))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3394 (define-foo-if-compiler-macros
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3395 (remove-if . remove*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3396 (remove-if-not . remove*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3397 (delete-if . delete*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3398 (delete-if-not . delete*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3399 (find-if . find)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3400 (find-if-not . find)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3401 (position-if . position)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3402 (position-if-not . position)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3403 (count-if . count)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3404 (count-if-not . count)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3405 (member-if . member*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3406 (member-if-not . member*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3407 (assoc-if . assoc*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3408 (assoc-if-not . assoc*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3409 (rassoc-if . rassoc*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3410 (rassoc-if-not . rassoc*)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3411
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3412 (macrolet
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3413 ((define-substitute-if-compiler-macros (&rest alist)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3414 "Like the above, but for `substitute-if' and friends."
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3415 (cons
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3416 'progn
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3417 (mapcar
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3418 (function*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3419 (lambda ((function-if . function))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3420 (let ((keyword (if (equal (substring (symbol-name function-if) -3)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3421 "not")
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3422 :if-not
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3423 :if)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3424 `(define-compiler-macro ,function-if (&whole form &rest args)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3425 (if (and (nthcdr 3 form)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3426 (or (consp (cl-const-expr-val (third form)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3427 (cl-safe-expr-p (third form))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3428 `(,',function ,(second form) ',',function ,(fourth form)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3429 ,,keyword ,(third form) ,@(nthcdr 4 form))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3430 form)))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3431 alist))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3432 (define-substitute-if-compiler-macros
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3433 (substitute-if . substitute)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3434 (substitute-if-not . substitute)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3435 (nsubstitute-if . nsubstitute)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3436 (nsubstitute-if-not . nsubstitute)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3437
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3438 (macrolet
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3439 ((define-subst-if-compiler-macros (&rest alist)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3440 "Like the above, but for `subst-if' and friends."
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3441 (cons
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3442 'progn
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3443 (mapcar
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3444 (function*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3445 (lambda ((function-if . function))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3446 (let ((keyword (if (equal (substring (symbol-name function-if) -3)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3447 "not")
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3448 :if-not
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3449 :if)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3450 `(define-compiler-macro ,function-if (&whole form &rest args)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3451 (if (and (nthcdr 3 form)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3452 (or (consp (cl-const-expr-val (third form)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3453 (cl-safe-expr-p (third form))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3454 `(,',function ,(if (cl-const-expr-p (second form))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3455 `'((nil . ,(cl-const-expr-val
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3456 (second form))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3457 `(list (cons ',',function
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3458 ,(second form))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3459 ,(fourth form) ,,keyword ,(third form)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3460 ,@(nthcdr 4 form))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3461 form)))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3462 alist))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3463 (define-subst-if-compiler-macros
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3464 (subst-if . sublis)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3465 (subst-if-not . sublis)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3466 (nsubst-if . nsublis)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3467 (nsubst-if-not . nsublis)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3468
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3469 (define-compiler-macro list* (arg &rest others)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3470 (let* ((args (reverse (cons arg others)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3471 (form (car args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3472 (while (setq args (cdr args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3473 (setq form (list 'cons (car args) form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3474 form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3475
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3476 ;; XEmacs change: our builtin get takes the default argument
440
8de8e3f6228a Import from CVS: tag r21-2-28
cvs
parents: 428
diff changeset
3477 (define-compiler-macro get* (sym prop &optional default)
8de8e3f6228a Import from CVS: tag r21-2-28
cvs
parents: 428
diff changeset
3478 (list 'get sym prop default))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3479
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
3480 (define-compiler-macro getf (sym prop &optional default)
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
3481 (list 'plist-get sym prop default))
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
3482
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3483 (define-compiler-macro typep (&whole form val type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3484 (if (cl-const-expr-p type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3485 (let ((res (cl-make-type-test val (cl-const-expr-val type))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3486 (if (or (memq (cl-expr-contains res val) '(nil 1))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3487 (cl-simple-expr-p val)) res
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3488 (let ((temp (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3489 (list 'let (list (list temp val)) (subst temp val res)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3490 form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3491
5085
1ee30d3f9dd0 Handle the :from-end argument correctly, #'delete-duplicates compiler macro.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5084
diff changeset
3492 (define-compiler-macro delete-dups (list)
1ee30d3f9dd0 Handle the :from-end argument correctly, #'delete-duplicates compiler macro.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5084
diff changeset
3493 `(delete-duplicates (the list ,list) :test #'equal :from-end t))
1ee30d3f9dd0 Handle the :from-end argument correctly, #'delete-duplicates compiler macro.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5084
diff changeset
3494
1ee30d3f9dd0 Handle the :from-end argument correctly, #'delete-duplicates compiler macro.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5084
diff changeset
3495 ;; XEmacs; inline delete-duplicates if it's called with one of the
1ee30d3f9dd0 Handle the :from-end argument correctly, #'delete-duplicates compiler macro.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5084
diff changeset
3496 ;; common compile-time constant tests and an optional :from-end
1ee30d3f9dd0 Handle the :from-end argument correctly, #'delete-duplicates compiler macro.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5084
diff changeset
3497 ;; argument, we want the speed in font-lock.el.
5317
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3498 (define-compiler-macro delete-duplicates (&whole form &rest cl-keys)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3499 (let ((cl-seq (if cl-keys (pop cl-keys))))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3500 (if (or
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3501 (not (or (memq (car-safe cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3502 ;; No need to check for a list at runtime with
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3503 ;; these. We could expand the list, but these are all
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3504 ;; the functions in the relevant context at the moment.
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3505 '(nreverse append nconc mapcan mapcar string-to-list))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3506 (and (listp cl-seq) (equal (butlast cl-seq) '(the list)))))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3507 ;; Wrong number of arguments.
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3508 (not (cdr form)))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3509 form
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3510 (cond
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3511 ((or (plists-equal cl-keys '(:test 'eq) t)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3512 (plists-equal cl-keys '(:test #'eq) t))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3513 `(let* ((begin ,cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3514 cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3515 (while (memq (car begin) (cdr begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3516 (setq begin (cdr begin)))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3517 (setq cl-seq begin)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3518 (while (cddr cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3519 (if (memq (cadr cl-seq) (cddr cl-seq))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3520 (setcdr (cdr cl-seq) (cddr cl-seq)))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3521 (setq cl-seq (cdr cl-seq)))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3522 begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3523 ((or (plists-equal cl-keys '(:test 'eq :from-end t) t)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3524 (plists-equal cl-keys '(:test #'eq :from-end t) t))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3525 `(let* ((begin ,cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3526 (cl-seq begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3527 (while cl-seq
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3528 (setq cl-seq (setcdr cl-seq
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3529 (delq (car cl-seq) (cdr cl-seq)))))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3530 begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3531 ((or (plists-equal cl-keys '(:test 'equal) t)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3532 (plists-equal cl-keys '(:test #'equal) t))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3533 `(let* ((begin ,cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3534 cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3535 (while (member (car begin) (cdr begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3536 (setq begin (cdr begin)))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3537 (setq cl-seq begin)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3538 (while (cddr cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3539 (if (member (cadr cl-seq) (cddr cl-seq))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3540 (setcdr (cdr cl-seq) (cddr cl-seq)))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3541 (setq cl-seq (cdr cl-seq)))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3542 begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3543 ((or (plists-equal cl-keys '(:test 'equal :from-end t) t)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3544 (plists-equal cl-keys '(:test #'equal :from-end t) t))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3545 `(let* ((begin ,cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3546 (cl-seq begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3547 (while cl-seq
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3548 (setq cl-seq (setcdr cl-seq (delete (car cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3549 (cdr cl-seq)))))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3550 begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3551 (t form)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3552
4723
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3553 ;; XEmacs; it's perfectly reasonable, and often much clearer to those
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3554 ;; reading the code, to call regexp-quote on a constant string, which is
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3555 ;; something we can optimise here easily.
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3556 (define-compiler-macro regexp-quote (&whole form string)
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3557 (if (stringp string)
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3558 (regexp-quote string)
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3559 form))
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3560
4906
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3561 ;; NOTE: `equalp' is now a primitive, although as of yet it still doesn't
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3562 ;; have a byte-compiler opcode for it. The compiler-macro for `equalp' used
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3563 ;; to try and remove as much as possible of the logic of the Lisp `equalp' as
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3564 ;; possible whenever one of the arguments is a constant, boiling things down
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3565 ;; to a few if-statements and some calls to various no-longer-defined
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3566 ;; helper functions. Besides the fact that the helper functions aren't
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3567 ;; defined, there's little point in doing any of that expansion, since it will
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3568 ;; end up executing in Lisp what would otherwise be done in C by a direct
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3569 ;; call to `equalp'. The only exception is when the reduction is quite
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3570 ;; simple and is to functions that do have op-codes; that may gain something.
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3571 ;; However, if `equalp' becomes an opcode itself, consider removing everything
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3572 ;; here except maybe when the call can directly be reduced to `equal' or `eq'.
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3573 ;;
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3574 ;; --ben
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3575
4792
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3576 (define-compiler-macro equalp (&whole form x y)
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3577 "Expand calls to `equalp' where X or Y is a constant expression.
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3578
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3579 Much of the processing that `equalp' does is dependent on the types of both
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3580 of its arguments, and with type information for one of them, we can
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3581 eliminate much of the body of the function at compile time.
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3582
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3583 Where both X and Y are constant expressions, `equalp' is evaluated at
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3584 compile time by byte-optimize.el--this compiler macro passes FORM through to
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3585 the byte optimizer in those cases."
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3586 ;; Cases where both arguments are constant are handled in
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3587 ;; byte-optimize.el, we only need to handle those cases where one is
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3588 ;; constant here.
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3589 (let* ((equalp-sym (eval-when-compile (gensym)))
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3590 (let-form '(progn))
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3591 (original-y y)
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3592 equalp-temp checked)
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3593 (macrolet
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3594 ((unordered-check (check)
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3595 `(prog1
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3596 (setq checked
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3597 (or ,check
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3598 (prog1 ,(sublis '((x . y) (y . x)) check :test #'eq)
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3599 (setq equalp-temp x x y y equalp-temp))))
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3600 (when checked
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3601 (unless (symbolp y)
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3602 (setq let-form `(let ((,equalp-sym ,y))) y equalp-sym))))))
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3603 ;; In the bodies of the below clauses, x is always a constant expression
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3604 ;; of the type we're interested in, and y is always a symbol that refers
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3605 ;; to the result non-constant side of the comparison.
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3606 (cond ((unordered-check (and (arrayp x) (not (cl-const-expr-p y))))
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3607 ;; Strings and other arrays. A vector containing the same
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3608 ;; character elements as a given string is equalp to that string;
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3609 ;; a bit-vector can only be equalp to a string if both are
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3610 ;; zero-length.
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3611 (cond
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3612 ((member x '("" #* []))
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3613 ;; No need to protect against multiple evaluation here:
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3614 `(and (member ,original-y '("" #* [])) t))
4906
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3615 (t form)))
4792
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3616 ((unordered-check (and (numberp x) (not (cl-const-expr-p y))))
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3617 `(,@let-form
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3618 (and (numberp ,y)
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3619 (= ,x ,y))))
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3620 ((unordered-check (and (hash-table-p x) (not (cl-const-expr-p y))))
4906
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3621 form)
4792
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3622 ((unordered-check
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3623 ;; Symbols; eq.
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3624 (and (not (cl-const-expr-p y))
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3625 (or (memq x '(nil t))
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3626 (and (eq (car-safe x) 'quote) (symbolp (second x))))))
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3627 (cons 'eq (cdr form)))
4906
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3628
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3629 ;; This clause is wrong -- e.g. when comparing a constant char-table
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3630 ;; against a non-constant expression that evaluates to a char-table,
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3631 ;; or some for range tables or certain other types, `equalp' is
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3632 ;; not the same as `equal'. We could insert the known list of
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3633 ;; types with special `equalp' property, but it's fragile and may
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3634 ;; not be much of an optimization, esp. since these types don't
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3635 ;; occur that often are often big.
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3636 ;;((unordered-check
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3637 ;; ;; Compare conses at runtime, there's no real upside to
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3638 ;; ;; unrolling the function -> they fall through to the next
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3639 ;; ;; clause in this function.
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3640 ;; (and (cl-const-expr-p x) (not (consp x))
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3641 ;; (not (cl-const-expr-p y))))
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3642 ;; ;; All other types; use equal.
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3643 ;; (cons 'equal (cdr form)))
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3644
4792
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3645 ;; Neither side is a constant expression, do all our evaluation at
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3646 ;; runtime (or both are, and equalp will be called from
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3647 ;; byte-optimize.el).
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3648 (t form)))))
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3649
4997
8800b5350a13 Move #'some, #'every to C, implementing them with mapcarX.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4996
diff changeset
3650 (define-compiler-macro notany (&whole form &rest cl-rest)
5153
f552caabf58b Correct the notany, notevery compiler macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5099
diff changeset
3651 `(not (some ,@(cdr form))))
4997
8800b5350a13 Move #'some, #'every to C, implementing them with mapcarX.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4996
diff changeset
3652
8800b5350a13 Move #'some, #'every to C, implementing them with mapcarX.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4996
diff changeset
3653 (define-compiler-macro notevery (&whole form &rest cl-rest)
5153
f552caabf58b Correct the notany, notevery compiler macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5099
diff changeset
3654 `(not (every ,@(cdr form))))
4997
8800b5350a13 Move #'some, #'every to C, implementing them with mapcarX.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4996
diff changeset
3655
5056
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3656 (define-compiler-macro constantly (&whole form value &rest more-values)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3657 (cond
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3658 ((< (length form) 2)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3659 ;; Error at runtime:
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3660 form)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3661 ((cl-const-exprs-p (cdr form))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3662 `#'(lambda (&rest ignore) (values ,@(cdr form))))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3663 (t
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3664 (let* ((num-values (length (cdr form)))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3665 (placeholders-counts (make-vector num-values -1))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3666 (placeholders (loop
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3667 for i from 0 below num-values
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3668 collect (make-symbol (format "%d" i))))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3669 (compiled
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3670 (byte-compile-sexp
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3671 `#'(lambda (&rest ignore)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3672 ;; Compiles to a references into the compiled function
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3673 ;; constants vector:
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3674 (values ,@(mapcar #'quote-maybe placeholders)))))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3675 position)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3676 `(make-byte-code '(&rest ignore)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3677 ,(compiled-function-instructions compiled)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3678 (vector ,@(loop
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3679 for constant across (compiled-function-constants compiled)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3680 collect (if (setq position
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3681 (position constant placeholders))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3682 (prog2
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3683 (incf (aref placeholders-counts position))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3684 (nth position (cdr form)))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3685 (quote-maybe constant))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3686 finally
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3687 (assert (every #'zerop placeholders-counts)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3688 t "Placeholders should each have been used once")))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3689 ,(compiled-function-stack-depth compiled))))))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3690
5182
2e528066e2fc Move #'sort*, #'fill, #'merge to C from cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5153
diff changeset
3691 (define-compiler-macro stable-sort (&whole form &rest cl-rest)
2e528066e2fc Move #'sort*, #'fill, #'merge to C from cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5153
diff changeset
3692 (cons 'sort* (cdr form)))
2e528066e2fc Move #'sort*, #'fill, #'merge to C from cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5153
diff changeset
3693
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3694 (define-compiler-macro svref (&whole form)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3695 (cons 'aref (cdr form)))
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3696
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3697 (define-compiler-macro acons (a b c)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3698 `(cons (cons ,a ,b) ,c))
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3699
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3700 (define-compiler-macro pairlis (a b &optional c)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3701 `(nconc (mapcar* #'cons ,a ,b) ,c))
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3702
5380
919c77c567bb Add compiler macros for #'revappend, #'nreconc.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5379
diff changeset
3703 (define-compiler-macro revappend (&whole form &rest args)
919c77c567bb Add compiler macros for #'revappend, #'nreconc.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5379
diff changeset
3704 (if (eql 3 (length form)) `(nconc (reverse ,(pop args)) ,(pop args)) form))
919c77c567bb Add compiler macros for #'revappend, #'nreconc.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5379
diff changeset
3705
919c77c567bb Add compiler macros for #'revappend, #'nreconc.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5379
diff changeset
3706 (define-compiler-macro nreconc (&whole form &rest args)
919c77c567bb Add compiler macros for #'revappend, #'nreconc.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5379
diff changeset
3707 (if (eql 3 (length form)) `(nconc (nreverse ,(pop args)) ,(pop args)) form))
919c77c567bb Add compiler macros for #'revappend, #'nreconc.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5379
diff changeset
3708
5226
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3709 (define-compiler-macro complement (&whole form fn)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3710 (if (or (eq (car-safe fn) 'function) (eq (car-safe fn) 'quote))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3711 (cond
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3712 ((and (symbolp (second fn)) (get (second fn) 'byte-compile-negated-op))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3713 (list 'function (get (second fn) 'byte-compile-negated-op)))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3714 ((and (symbolp (second fn)) (fboundp (second fn))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3715 (compiled-function-p (indirect-function (second fn))))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3716 (let* ((cf (indirect-function (second fn)))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3717 (cfa (compiled-function-arglist cf))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3718 (do-apply (memq '&rest cfa)))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3719 `#'(lambda ,cfa
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3720 (not (,@(if do-apply `(apply ',(second fn)) (list (second fn)))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3721 ,@(remq '&optional
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3722 (remq '&rest cfa)))))))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3723 (t
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3724 `#'(lambda (&rest arguments)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3725 (not (apply ,fn arguments)))))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3726 ;; Determine the function to call at runtime.
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3727 (destructuring-bind
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3728 (arglist instructions constants stack-depth)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3729 (let ((compiled-lambda
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3730 (byte-compile-sexp
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3731 #'(lambda (&rest arguments)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3732 (not (apply 'placeholder arguments))))))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3733 (list
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3734 (compiled-function-arglist compiled-lambda)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3735 (compiled-function-instructions compiled-lambda)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3736 (append (compiled-function-constants compiled-lambda) nil)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3737 (compiled-function-stack-depth compiled-lambda)))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3738 `(make-byte-code
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3739 ',arglist ,instructions (vector
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3740 ,@(nsublis
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3741 (list (cons (quote-maybe
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3742 'placeholder)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3743 fn))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3744 (mapcar #'quote-maybe constants)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3745 :test #'equal))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3746 ,stack-depth))))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3747
5242
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3748 (define-compiler-macro concatenate (&whole form type &rest seqs)
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3749 (if (and (cl-const-expr-p type) (memq (cl-const-expr-val type)
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3750 '(vector bit-vector list string)))
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3751 (case (cl-const-expr-val type)
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3752 (list (append (list 'append) (cddr form) '(nil)))
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3753 (vector (cons 'vconcat (cddr form)))
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3754 (bit-vector (cons 'bvconcat (cddr form)))
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3755 (string (cons 'concat (cddr form))))
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3756 form))
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3757
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3758 (define-compiler-macro subst-char-in-string (&whole form fromchar tochar
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3759 string &optional inplace)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3760 (if (every #'cl-safe-expr-p (cdr form))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3761 `(funcall (if ,inplace #'nsubstitute #'substitute) ,tochar ,fromchar
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3762 (the string ,string) :test #'eq)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3763 form))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3764
5329
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3765 (define-compiler-macro stable-union (&whole form &rest cl-keys)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3766 (if (> (length form) 2)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3767 (list* 'union (pop cl-keys) (pop cl-keys) :stable t cl-keys)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3768 form))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3769
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3770 (define-compiler-macro stable-intersection (&whole form &rest cl-keys)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3771 (if (> (length form) 2)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3772 (list* 'intersection (pop cl-keys) (pop cl-keys) :stable t cl-keys)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3773 form))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3774
5266
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3775 (map nil
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3776 #'(lambda (function)
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3777 ;; There are byte codes for the two-argument versions of these
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3778 ;; functions; if the form has more arguments and those arguments
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3779 ;; have no side effects, transform to a series of two-argument
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3780 ;; calls.
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3781 (put function 'cl-compiler-macro
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3782 #'(lambda (form &rest arguments)
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3783 (if (or (null (nthcdr 3 form))
5314
596011a8bf8f = < > <= >=: it's OK to use the compiler macro when first, last args side effect
Aidan Kehoe <kehoea@parhasard.net>
parents: 5313
diff changeset
3784 (notevery #'cl-safe-expr-p (butlast (cdr arguments))))
5266
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3785 form
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3786 (cons 'and (mapcon
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3787 #'(lambda (rest)
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3788 (and (cdr rest)
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3789 `((,(car form) ,(pop rest)
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3790 ,(car rest)))))
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3791 (cdr form)))))))
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3792 '(= < > <= >=))
f9ec07abdbf9 Transform safe calls to (= X Y Z) to (and (= X Y) (= Y Z)); same for < > <= >=
Aidan Kehoe <kehoea@parhasard.net>
parents: 5263
diff changeset
3793
5313
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3794 ;; XEmacs; unroll this loop at macro-expansion time, so the compiler macros
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3795 ;; are byte-compiled.
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3796 (macrolet
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3797 ((inline-side-effect-free-compiler-macros (&rest details)
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3798 (cons
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3799 'progn
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3800 (loop
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3801 for (function . details) in details
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3802 nconc `((put ',function 'side-effect-free t)
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3803 (define-compiler-macro ,function (&whole form x)
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3804 ,(if (symbolp (car details))
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3805 (reduce #'(lambda (object1 object2)
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3806 `(list ',object1 ,object2))
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3807 details :from-end t :initial-value 'x)
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3808 (cons 'list details))))))))
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3809 (inline-side-effect-free-compiler-macros
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3810 (first 'car x) (second 'cadr x) (third 'caddr x) (fourth 'cadddr x)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3811 (fifth 'nth 4 x) (sixth 'nth 5 x) (seventh 'nth 6 x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3812 (eighth 'nth 7 x) (ninth 'nth 8 x) (tenth 'nth 9 x)
5285
99de5fd48e87 Tighten up Common Lisp compatibility, #'butlast, #'nbutlast, #'tailp, #'ldiff
Aidan Kehoe <kehoea@parhasard.net>
parents: 5269
diff changeset
3813 (rest 'cdr x) (plusp '> x 0) (minusp '< x 0)
5313
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3814 (oddp 'eql (list 'logand x 1) 1)
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3815 (evenp 'eql (list 'logand x 1) 0)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3816 (caar car car) (cadr car cdr) (cdar cdr car) (cddr cdr cdr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3817 (caaar car caar) (caadr car cadr) (cadar car cdar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3818 (caddr car cddr) (cdaar cdr caar) (cdadr cdr cadr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3819 (cddar cdr cdar) (cdddr cdr cddr) (caaaar car caaar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3820 (caaadr car caadr) (caadar car cadar) (caaddr car caddr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3821 (cadaar car cdaar) (cadadr car cdadr) (caddar car cddar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3822 (cadddr car cdddr) (cdaaar cdr caaar) (cdaadr cdr caadr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3823 (cdadar cdr cadar) (cdaddr cdr caddr) (cddaar cdr cdaar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3824 (cddadr cdr cdadr) (cdddar cdr cddar) (cddddr cdr cdddr)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3825
5339
ba62563ec7c7 Accept more complex TYPEs in #'concatenate, cl-extra.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5338
diff changeset
3826 ;;; Things that are inline. XEmacs; the functions that used to be here have
ba62563ec7c7 Accept more complex TYPEs in #'concatenate, cl-extra.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5338
diff changeset
3827 ;;; compiler macros or are built-in.
ba62563ec7c7 Accept more complex TYPEs in #'concatenate, cl-extra.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5338
diff changeset
3828 (proclaim '(inline cl-set-elt))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3829
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3830 ;;; Things that are side-effect-free. Moved to byte-optimize.el
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3831 ;(mapcar (function (lambda (x) (put x 'side-effect-free t)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3832 ; '(oddp evenp signum last butlast ldiff pairlis gcd lcm
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3833 ; isqrt floor* ceiling* truncate* round* mod* rem* subseq
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3834 ; list-length get* getf))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3835
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3836 ;;; Things that are side-effect-and-error-free. Moved to byte-optimize.el
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3837 ;(mapcar (function (lambda (x) (put x 'side-effect-free 'error-free)))
4885
6772ce4d982b Fix hash tables, #'member*, #'assoc*, #'eql compiler macros if bignums
Aidan Kehoe <kehoea@parhasard.net>
parents: 4820
diff changeset
3838 ; '(eql list* subst acons equalp random-state-p
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3839 ; copy-tree sublis))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3840
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3841
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3842 (run-hooks 'cl-macs-load-hook)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3843
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3844 ;;; arch-tag: afd947a6-b553-4df1-bba5-000be6388f46
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3845 ;;; cl-macs.el ends here