annotate lisp/cl-macs.el @ 5934:e2fae7783046 cygwin

lots of use of EMACS_INT, a few others, to eliminate all pointer truncation warnings
author Henry Thompson <ht@markup.co.uk>
date Sat, 12 Dec 2015 19:08:46 +0000
parents 4004c3266c09
children bd644055ef44
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
5402
308d34e9f07d Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents: 5269
diff changeset
12 ;; XEmacs is free software: you can redistribute it and/or modify it
308d34e9f07d Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents: 5269
diff changeset
13 ;; under the terms of the GNU General Public License as published by the
308d34e9f07d Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents: 5269
diff changeset
14 ;; Free Software Foundation, either version 3 of the License, or (at your
308d34e9f07d Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents: 5269
diff changeset
15 ;; option) any later version.
308d34e9f07d Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents: 5269
diff changeset
16
308d34e9f07d Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents: 5269
diff changeset
17 ;; XEmacs is distributed in the hope that it will be useful, but WITHOUT
308d34e9f07d Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents: 5269
diff changeset
18 ;; ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
308d34e9f07d Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents: 5269
diff changeset
19 ;; FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
308d34e9f07d Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents: 5269
diff changeset
20 ;; for more details.
428
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
5402
308d34e9f07d Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents: 5269
diff changeset
23 ;; along with XEmacs. If not, see <http://www.gnu.org/licenses/>.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
24
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
25 ;;; Synched up with: FSF 21.3.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
26
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
27 ;;; Commentary:
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 ;; These are extensions to Emacs Lisp that provide a degree of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
30 ;; Common Lisp compatibility, beyond what is already built-in
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
31 ;; in Emacs Lisp.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
32 ;;
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
33 ;; This package was written by Dave Gillespie; it is a complete
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
34 ;; rewrite of Cesar Quiroz's original cl.el package of December 1986.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
35 ;;
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
36 ;; Bug reports, comments, and suggestions are welcome!
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 ;; This file contains the portions of the Common Lisp extensions
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
39 ;; package which should be autoloaded, but need only be present
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
40 ;; if the compiler or interpreter is used---this file is not
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
41 ;; necessary for executing compiled code.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
42
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
43 ;; See cl.el for Change Log.
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
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
46 ;;; Code:
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 (defmacro cl-pop2 (place)
5651
ae2fdb1fd9e0 Improve for-effect handling in a few places, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents: 5632
diff changeset
49 (list 'prog1 (list 'car-safe (list 'cdr-safe place))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
50 (list 'setq place (list 'cdr (list 'cdr place)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
51 (put 'cl-pop2 'edebug-form-spec 'edebug-sexps)
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 (defvar cl-optimize-safety)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
54 (defvar cl-optimize-speed)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
55
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
56 ;;; Initialization.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
57
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
58 (defvar cl-old-bc-file-form nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
59
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
60 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
61 (defun cl-compile-time-init ()
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
62 (run-hooks 'cl-hack-bytecomp-hook))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
63
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
64
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
65 ;;; 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
66 ;;; 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
67
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
68 (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
69 car-safe cdr-safe progn prog1 prog2))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
70 (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
71 < > <= >= = error))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
72
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
73 ;;; Check if no side effects, and executes quickly.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
74 (defun cl-simple-expr-p (x &optional size)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
75 (or size (setq size 10))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
76 (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
77 (and (symbolp (car x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
78 (or (memq (car x) cl-simple-funcs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
79 (get (car x) 'side-effect-free))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
80 (progn
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
81 (setq size (1- size))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
82 (while (and (setq x (cdr x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
83 (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
84 (and (null x) (>= size 0) size)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
85 (and (> size 0) (1- size))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
86
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
87 (defun cl-simple-exprs-p (xs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
88 (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
89 (setq xs (cdr xs)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
90 (not xs))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
91
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
92 ;;; Check if no side effects.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
93 (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
94 (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
95 '(quote function function* lambda)))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
96 (and (symbolp (car x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
97 (or (memq (car x) cl-simple-funcs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
98 (memq (car x) cl-safe-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 (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
102 (null x)))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
103
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
104 ;;; 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
105 (defun cl-const-expr-p (x)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
106 (cond ((consp x)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
107 (or (eq (car x) 'quote)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
108 (and (memq (car x) '(function function*))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
109 (or (symbolp (nth 1 x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
110 (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
111 ((symbolp x) (and (memq x '(nil t)) t))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
112 (t t)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
113
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
114 (defun cl-const-exprs-p (xs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
115 (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
116 (setq xs (cdr xs)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
117 (not xs))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
118
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
119 (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
120 (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
121 (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
122 ((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
123 (cl-not-constant))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
124
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
125 (defun cl-expr-access-order (x v)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
126 (if (cl-const-expr-p x) v
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
127 (if (consp x)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
128 (progn
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
129 (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
130 v)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
131 (if (eq x (car v)) (cdr v) '(t)))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
132
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
133 ;;; 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
134 (defun cl-expr-contains (x y)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
135 (cond ((equal y x) 1)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
136 ((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
137 (let ((sum 0))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
138 (while x
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
139 (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
140 (and (> sum 0) sum)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
141 (t nil)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
142
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
143 (defun cl-expr-contains-any (x y)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
144 (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
145 y)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
146
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
147 ;;; 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
148 (defun cl-expr-depends-p (x y)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
149 (and (not (cl-const-expr-p x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
150 (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
151
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
152 ;;; Symbols.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
154 (defvar *gensym-counter*)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
155
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
156 ;; 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
157
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
158
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
159 ;;; Program structure.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
160
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
161 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
162 (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
163 "Define NAME as a function.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
164 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
165 and BODY is implicitly surrounded by (block NAME ...).
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
166
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
167 \"Full Common Lisp conventions\" means that:
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
168
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
169 -- 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
170 &allow-other-keys, and &aux are allowed.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
171
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
172 -- 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
173 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
174 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
175 INITFORM is omitted) and stored as VAR's value, and SVAR is bound to t.
5632
bd80d9103fc8 Integrate CL code better into core, remove obsolete compatibility code.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5624
diff changeset
176 If an argument is available for VAR, and INITFORM is unused, SVAR is
872
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
177 bound to nil.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
178
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
179 -- &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
180 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
181
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
182 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
183 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
184 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
185
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
186 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
187 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
188
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
189 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
190 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
191 expression.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
192
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
193 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
194 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
195
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
196 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
197 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
198
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
199 -- &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
200 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
201 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
202
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
203 -- &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
204 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
205 format of `let'/`let*' bindings.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
206 "
5509
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
207 (list* 'defun name (cdr (cl-transform-lambda (list* arglist docstring body)
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
208 name))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
209
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
210 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
211 (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
212 "Define NAME as a macro.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
213 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
214 and BODY is implicitly surrounded by (block NAME ...).
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
215
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
216 \"Full Common Lisp conventions\" means that:
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
217
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
218 -- 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
219 &aux are allowed, as in `defun*'.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
220
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
221 -- 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
222 &environment:
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
223
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
224 &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
225 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
226 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
227
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
228 &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
229 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
230 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
231
5658
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
232 &environment allows access to the macro environment at the time of
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
233 expansion; it is most relevant when it's necessary to force macro expansion
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
234 of the body of a form at the time of macro expansion of its top level.
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
235 &environment is followed by variable name, and this variable will be bound
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
236 to the value of the macro environment within BODY. See the ENVIRONMENT
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
237 argument to `macroexpand'.
872
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 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
240 `destructuring-bind', which destructures exactly like `defmacro*', and
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
241 `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
242 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
243 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
244 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
245 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
246 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
247 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
248 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
249 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
250 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
251 as an argument.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
252
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
253 See `loop' for practical examples of destructuring, but
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
254 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
255 destructuring in that
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
256
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
257 (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
258 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
259 simple matching.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
260 (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
261 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
262 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
263 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
264 receive a value of nil, etc.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
265 "
5509
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
266 (list* 'defmacro name (cdr (cl-transform-lambda (list* arglist docstring body)
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
267 name))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
268
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
269 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
270 (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
271 "Introduce a function.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
272 Like normal `function', except that if argument is a lambda form, its
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
273 ARGLIST allows full Common Lisp conventions."
5509
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
274 `(function
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
275 ,(if (eq (car-safe symbol-or-lambda) 'lambda)
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
276 (cons 'lambda (cdr (cl-transform-lambda (cdr symbol-or-lambda)
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
277 'cl-none)))
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
278 symbol-or-lambda)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
279
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
280 (defun cl-transform-function-property (func prop form)
5614
281bf2b87915 Call #'cl-macroexpand-all in #'cl-transform-function-property
Aidan Kehoe <kehoea@parhasard.net>
parents: 5609
diff changeset
281 (cl-macroexpand-all
281bf2b87915 Call #'cl-macroexpand-all in #'cl-transform-function-property
Aidan Kehoe <kehoea@parhasard.net>
parents: 5609
diff changeset
282 `(put ',func ',prop #'(lambda ,@(cdr (cl-transform-lambda form func))))
281bf2b87915 Call #'cl-macroexpand-all in #'cl-transform-function-property
Aidan Kehoe <kehoea@parhasard.net>
parents: 5609
diff changeset
283 byte-compile-macro-environment))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
284
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
285 (defconst lambda-list-keywords
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
286 '(&optional &rest &key &allow-other-keys &aux &whole &body &environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
287
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
288 (defvar bind-block) (defvar bind-defs) (defvar bind-enquote)
5509
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
289 (defvar bind-lets) (defvar bind-forms)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
290
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
291 ;; npak@ispras.ru
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
292 (defun cl-upcase-arg (arg)
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
293 ;; Changes all non-keyword symbols in `ARG' to symbols
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
294 ;; with name in upper case.
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
295 ;; ARG is either symbol or list of symbols or lists
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
296 (cond ((symbolp arg)
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
297 ;; 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
298 (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
299 arg
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
300 (make-symbol (upcase (symbol-name arg)))))
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
301 ((listp arg)
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
302 (let ((arg (copy-list arg)) junk)
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
303 ;; Clean the list
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
304 (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
305 (if (setq junk (cadr (memq '&cl-defs arg)))
5652
cc6f0266bc36 Avoid #'delq in core Lisp, for the sake of style, a very slightly smaller binary
Aidan Kehoe <kehoea@parhasard.net>
parents: 5651
diff changeset
306 (setq arg (delete* '&cl-defs (delete* junk arg))))
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
307 (if (memq '&cl-quote arg)
5652
cc6f0266bc36 Avoid #'delq in core Lisp, for the sake of style, a very slightly smaller binary
Aidan Kehoe <kehoea@parhasard.net>
parents: 5651
diff changeset
308 (setq arg (delete* '&cl-quote arg)))
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
309 (mapcar 'cl-upcase-arg arg)))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
310 (t arg))) ; Maybe we are in initializer
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
311
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
312 ;; npak@ispras.ru, modified by ben@666.com
4702
eb1a409c317b Unbreak autoload.el
Mike Sperber <sperber@deinprogramm.de>
parents: 4695
diff changeset
313 ;;;###autoload
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
314 (defun cl-function-arglist (arglist)
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
315 "Returns string with printed representation of arguments list.
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
316 Supports Common Lisp lambda lists."
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
317 (if (not (or (listp arglist) (symbolp arglist)))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
318 "Not available"
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
319 (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
320 (let ((print-gensym nil))
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
321 (condition-case nil
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
322 (let ((args (cond ((null arglist) nil)
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
323 ((listp arglist) (cl-upcase-arg arglist))
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
324 ((symbolp arglist)
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
325 (cl-upcase-arg (list '&rest arglist)))
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
326 (t (wrong-type-argument 'listp arglist)))))
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
327 (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
328 (t "Not available")))))
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
329
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
330 (defun cl-transform-lambda (form bind-block)
5509
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
331 "Transform a lambda expression to support Common Lisp conventions.
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
332
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
333 FORM is the cdr of the lambda expression. BIND-BLOCK is the implicit block
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
334 name that's added, typically the name of the associated function. It can be
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
335 the symbol `cl-none', to indicate no implicit block is needed.
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
336
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
337 The Common Lisp conventions described are those detailed in the `defun*' and
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
338 `defmacro*' docstrings. This function returns a list with the first element
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
339 nil, to be ignored. The rest of the list represents a transformed lambda
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
340 expression, with any argument list parsing code necessary, and a surrounding
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
341 block."
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
342 (let* ((args (car form)) (body (cdr form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
343 (bind-defs nil) (bind-enquote nil)
5509
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
344 (bind-lets nil) (bind-forms nil)
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
345 (header nil) (simple-args nil)
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
346 (complex-arglist (cl-function-arglist args))
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
347 (doc ""))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
348 (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
349 (push (pop body) header))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
350 (setq args (if (listp args) (copy-list args) (list '&rest args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
351 (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
352 (if (setq bind-defs (cadr (memq '&cl-defs args)))
5652
cc6f0266bc36 Avoid #'delq in core Lisp, for the sake of style, a very slightly smaller binary
Aidan Kehoe <kehoea@parhasard.net>
parents: 5651
diff changeset
353 (setq args (delete* '&cl-defs (delete* bind-defs args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
354 bind-defs (cadr bind-defs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
355 (if (setq bind-enquote (memq '&cl-quote args))
5652
cc6f0266bc36 Avoid #'delq in core Lisp, for the sake of style, a very slightly smaller binary
Aidan Kehoe <kehoea@parhasard.net>
parents: 5651
diff changeset
356 (setq args (delete* '&cl-quote args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
357 (if (memq '&whole args) (error "&whole not currently implemented"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
358 (let* ((p (memq '&environment args)) (v (cadr p)))
5652
cc6f0266bc36 Avoid #'delq in core Lisp, for the sake of style, a very slightly smaller binary
Aidan Kehoe <kehoea@parhasard.net>
parents: 5651
diff changeset
359 (if p (setq args (nconc (delete* (car p) (delete* v args))
5562
855b667dea13 Drop cl-macro-environment in favour of byte-compile-macro-environment.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5561
diff changeset
360 `(&aux (,v byte-compile-macro-environment))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
361 (while (and args (symbolp (car args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
362 (not (memq (car args) '(nil &rest &body &key &aux)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
363 (not (and (eq (car args) '&optional)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
364 (or bind-defs (consp (cadr args))))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
365 (push (pop args) simple-args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
366 (or (eq bind-block 'cl-none)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
367 (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
368 (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
369 header (nreverse header))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
370 (if (null args)
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
371 (list* nil simple-args (nconc header body))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
372 (if (memq '&optional simple-args) (push '&optional args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
373 (cl-do-arglist args nil (- (length simple-args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
374 (if (memq '&optional simple-args) 1 0)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
375 (setq bind-lets (nreverse bind-lets))
5509
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
376 ;; This code originally needed to create the keywords itself, that
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
377 ;; wasn't done by the Lisp reader; the first element of the result
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
378 ;; list comprised code to do this. It's not used any more.
5514
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
379 (list* nil (prog1
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
380 (setq simple-args
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
381 (nconc simple-args
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
382 (list '&rest (car (pop bind-lets)))))
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
383 ;; Add CL lambda list to documentation, if the CL lambda
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
384 ;; list differs from the non-CL lambda
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
385 ;; list. npak@ispras.ru
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
386 (unless (equal complex-arglist
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
387 (cl-function-arglist simple-args))
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
388 (and (stringp (car header)) (setq doc (pop header)))
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
389 ;; Stick the arguments onto the end of the doc string
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
390 ;; in a way that will be recognized specially by
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
391 ;; `function-arglist'.
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
392 (push (concat doc "\n\narguments: " complex-arglist "\n")
9d519ab9fd68 Be a little better about deciding when to add CL docstring argument info.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5511
diff changeset
393 header)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
394 ;; 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
395 ;; approach above
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
396 (nconc header
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
397 (list (nconc (list 'let* bind-lets)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
398 (nreverse bind-forms) body)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
399
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
400 (defun cl-do-arglist (args expr &optional num) ; uses bind-*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
401 (if (nlistp args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
402 (if (or (memq args lambda-list-keywords) (not (symbolp args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
403 (error "Invalid argument name: %s" args)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
404 (push (list args expr) bind-lets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
405 (setq args (copy-list args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
406 (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
407 (let ((p (memq '&body args))) (if p (setcar p '&rest)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
408 (if (memq '&environment args) (error "&environment used incorrectly"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
409 (let ((save-args args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
410 (restarg (memq '&rest args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
411 (safety (if (cl-compiling-file) cl-optimize-safety 3))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
412 (keys nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
413 (laterarg nil) (exactarg nil) minarg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
414 (or num (setq num 0))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
415 (if (listp (cadr restarg))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
416 (setq restarg (gensym "--rest--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
417 (setq restarg (cadr restarg)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
418 (push (list restarg expr) bind-lets)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
419 (if (eq (car args) '&whole)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
420 (push (list (cl-pop2 args) restarg) bind-lets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
421 (let ((p args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
422 (setq minarg restarg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
423 (while (and p (not (memq (car p) lambda-list-keywords)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
424 (or (eq p args) (setq minarg (list 'cdr minarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
425 (setq p (cdr p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
426 (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
427 (setq minarg (list 'eql (list 'length restarg)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
428 (length (ldiff args p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
429 exactarg (not (eq args p)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
430 (while (and args (not (memq (car args) lambda-list-keywords)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
431 (let ((poparg (list (if (or (cdr args) (not exactarg)) 'pop 'car)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
432 restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
433 (cl-do-arglist
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
434 (pop args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
435 (if (or laterarg (= safety 0)) poparg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
436 (list 'if minarg poparg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
437 (list 'signal '(quote wrong-number-of-arguments)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
438 (list 'list (and (not (eq bind-block 'cl-none))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
439 (list 'quote bind-block))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
440 (list 'length restarg)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
441 (setq num (1+ num) laterarg t))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
442 (while (and (eq (car args) '&optional) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
443 (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
444 (let ((arg (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
445 (or (consp arg) (setq arg (list arg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
446 (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
447 (let ((def (if (cdr arg) (nth 1 arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
448 (or (car bind-defs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
449 (nth 1 (assq (car arg) bind-defs)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
450 (poparg (list 'pop restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
451 (and def bind-enquote (setq def (list 'quote def)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
452 (cl-do-arglist (car arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
453 (if def (list 'if restarg poparg def) poparg))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
454 (setq num (1+ num))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
455 (if (eq (car args) '&rest)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
456 (let ((arg (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
457 (if (consp arg) (cl-do-arglist arg restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
458 (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
459 (push (list 'if restarg
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
460 (list 'signal '(quote wrong-number-of-arguments)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
461 (list 'list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
462 (and (not (eq bind-block 'cl-none))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
463 (list 'quote bind-block))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
464 (list '+ num (list 'length restarg)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
465 bind-forms)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
466 (while (and (eq (car args) '&key) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
467 (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
468 (let ((arg (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
469 (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
470 (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
471 ;; 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
472 ;; 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
473 ;; Lisp issue:
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
474 (caar arg)
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
475 ;; 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
476 ;; 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
477 ;; longer in obarray:
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
478 (read (concat ":" (symbol-name (car arg))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
479 (varg (if (consp (car arg)) (cadar arg) (car arg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
480 (def (if (cdr arg) (cadr arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
481 (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
482 (look (list 'memq (quote-maybe karg) restarg)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
483 (and def bind-enquote (setq def (list 'quote def)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
484 (if (cddr arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
485 (let* ((temp (or (nth 2 arg) (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
486 (val (list 'car (list 'cdr temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
487 (cl-do-arglist temp look)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
488 (cl-do-arglist varg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
489 (list 'if temp
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
490 (list 'prog1 val (list 'setq temp t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
491 def)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
492 (cl-do-arglist
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
493 varg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
494 (list 'car
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
495 (list 'cdr
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
496 (if (null def)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
497 look
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
498 (list 'or look
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
499 (if (eq (cl-const-expr-p def) t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
500 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
501 'quote
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
502 (list nil (cl-const-expr-val def)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
503 (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
504 (push karg keys)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
505 (setq keys (nreverse keys))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
506 (or (and (eq (car args) '&allow-other-keys) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
507 (null keys) (= safety 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
508 (let* ((var (gensym "--keys--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
509 (allow '(:allow-other-keys))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
510 (check (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
511 'while var
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
512 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
513 'cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
514 (list (list 'memq (list 'car var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
515 (list 'quote (append keys allow)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
516 (list 'setq var (list 'cdr (list 'cdr var))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
517 (list (list 'car
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
518 (list 'cdr
4793
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
519 (list 'memq (car allow)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
520 restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
521 (list 'setq var nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
522 (list t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
523 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
524 'error
5084
6afe991b8135 Add a PARSE_KEYWORDS macro, use it in #'make-hash-table.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5080
diff changeset
525 ''invalid-keyword-argument
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
526 (list 'car var)))))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
527 (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
528 (while (and (eq (car args) '&aux) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
529 (while (and args (not (memq (car args) lambda-list-keywords)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
530 (if (consp (car args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
531 (if (and bind-enquote (cadar args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
532 (cl-do-arglist (caar args)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
533 (list 'quote (cadr (pop args))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
534 (cl-do-arglist (caar args) (cadr (pop args))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
535 (cl-do-arglist (pop args) nil))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
536 (if args (error "Malformed argument list %s" save-args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
537
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
538 (defun cl-arglist-args (args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
539 (if (nlistp args) (list args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
540 (let ((res nil) (kind nil) arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
541 (while (consp args)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
542 (setq arg (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
543 (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
544 (if (eq arg '&cl-defs) (pop args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
545 (and (consp arg) kind (setq arg (car arg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
546 (and (consp arg) (cdr arg) (eq kind '&key) (setq arg (cadr arg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
547 (setq res (nconc res (cl-arglist-args arg))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
548 (nconc res (and args (list args))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
549
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
550 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
551 (defmacro destructuring-bind (args expr &rest body)
872
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
552 "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
553 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
554 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
555 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
556 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
557 in `defmacro*'; see that for more information.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
558
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
559 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
560 gives practical examples of destructuring. `defmacro*' describes the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
561 differences between loop and macro-style destructuring.
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 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
564 `loop', approximately like this:
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
565
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
566 (loop for ARGS = EXPR
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
567 return (progn BODY))
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
568
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
569 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
570 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
571 results will be the same."
5509
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
572 (let ((bind-block 'cl-none) bind-lets bind-forms bind-defs)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
573 (cl-do-arglist (or args '(&aux)) expr)
5509
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
574 (nconc (list 'let* (nreverse bind-lets)) (nreverse bind-forms) body)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
575
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
576 ;;; The `eval-when' form.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
577
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
578 (defvar cl-not-toplevel nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
579
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
580 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
581 (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
582 "Control when BODY is evaluated.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
583 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
584 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
585 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
586
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
587 arguments: ((&rest WHEN) &body BODY)"
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
588 (if (and (fboundp 'cl-compiling-file) (cl-compiling-file)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
589 (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
590 (let ((comp (or (memq 'compile when) (memq :compile-toplevel when)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
591 (cl-not-toplevel t))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
592 (if (or (memq 'load when) (memq :load-toplevel when))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
593 (if comp (cons 'progn (mapcar 'cl-compile-time-too body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
594 (list* 'if nil nil body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
595 (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
596 (and (or (memq 'eval when) (memq :execute when))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
597 (cons 'progn body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
598
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
599 (defun cl-compile-time-too (form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
600 (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
601 (setq form (macroexpand
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
602 form (cons '(eval-when) byte-compile-macro-environment))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
603 (cond ((eq (car-safe form) 'progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
604 (cons 'progn (mapcar 'cl-compile-time-too (cdr form))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
605 ((eq (car-safe form) 'eval-when)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
606 (let ((when (nth 1 form)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
607 (if (or (memq 'eval when) (memq :execute when))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
608 (list* 'eval-when (cons 'compile when) (cddr form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
609 form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
610 (t (eval form) form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
611
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
612 ;;; Conditional control structures.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
613
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
614 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
615 (defmacro case (expr &rest clauses)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
616 "Evals EXPR, chooses from CLAUSES on that value.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
617 Each clause looks like (KEYLIST BODY...). EXPR is evaluated and compared
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
618 against each key in each KEYLIST; the corresponding BODY is evaluated.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
619 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
620 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
621 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
622 Key values are compared by `eql'."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
623 (let* ((temp (if (cl-simple-expr-p expr 3) expr (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
624 (head-list nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
625 (last-clause (car (last clauses)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
626 (body (cons
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
627 'cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
628 (mapcar
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
629 #'(lambda (c)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
630 (cons (cond ((memq (car c) '(t otherwise))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
631 ;; XEmacs addition: check for last clause
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
632 (or (eq c last-clause)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
633 (error
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
634 "`%s' is allowed only as the last case clause"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
635 (car c)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
636 t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
637 ((eq (car c) 'ecase-error-flag)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
638 (list 'error "ecase failed: %s, %s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
639 temp (list 'quote (reverse head-list))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
640 ((listp (car c))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
641 (setq head-list (append (car c) head-list))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
642 (list 'member* temp (list 'quote (car c))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
643 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
644 (if (memq (car c) head-list)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
645 (error "Duplicate key in case: %s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
646 (car c)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
647 (push (car c) head-list)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
648 (list 'eql temp (list 'quote (car c)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
649 (or (cdr c) '(nil))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
650 clauses))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
651 (if (eq temp expr) body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
652 (list 'let (list (list temp expr)) body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
653
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
654 ;; #### CL standard also requires `ccase', which signals a continuable
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
655 ;; error (`cerror' in XEmacs). However, I don't think it buys us
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
656 ;; anything to introduce it, as there is probably much more CL stuff
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
657 ;; missing, and the feature is not essential. --hniksic
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
658
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
659 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
660 (defmacro ecase (expr &rest clauses)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
661 "Like `case', but error if no case fits.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
662 `otherwise'-clauses are not allowed."
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
663 ;; XEmacs addition: disallow t and otherwise
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
664 (let ((disallowed (or (assq t clauses)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
665 (assq 'otherwise clauses))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
666 (if disallowed
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
667 (error "`%s' is not allowed in ecase" (car disallowed))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
668 (list* 'case expr (append clauses '((ecase-error-flag)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
669
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
670 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
671 (defmacro typecase (expr &rest clauses)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
672 "Evals EXPR, chooses from CLAUSES on that value.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
673 Each clause looks like (TYPE BODY...). EXPR is evaluated and, if it
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
674 satisfies TYPE, the corresponding BODY is evaluated. If no clause succeeds,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
675 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
676 final clause, and matches if no other keys match."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
677 (let* ((temp (if (cl-simple-expr-p expr 3) expr (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
678 (type-list nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
679 (body (cons
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
680 'cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
681 (mapcar
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
682 #'(lambda (c)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
683 (cons (cond ((eq (car c) 'otherwise) t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
684 ((eq (car c) 'ecase-error-flag)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
685 (list 'error "etypecase failed: %s, %s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
686 temp (list 'quote (reverse type-list))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
687 (t
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
688 (push (car c) type-list)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
689 (cl-make-type-test temp (car c))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
690 (or (cdr c) '(nil))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
691 clauses))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
692 (if (eq temp expr) body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
693 (list 'let (list (list temp expr)) body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
694
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
695 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
696 (defmacro etypecase (expr &rest clauses)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
697 "Like `typecase', but error if no case fits.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
698 `otherwise'-clauses are not allowed."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
699 (list* 'typecase expr (append clauses '((ecase-error-flag)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
700
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
701
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
702 ;;; Blocks and exits.
5353
38e24b8be4ea Improve the lexical scoping in #'block, #'return-from.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5346
diff changeset
703 (defvar cl-active-block-names nil)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
704
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
705 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
706 (defmacro block (name &rest body)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
707 "Define a lexically-scoped block named NAME.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
708 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
709 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
710 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
711 quoted symbol or other form; and second, NAME is lexically rather than
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
712 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
713 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
714 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
715 (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
716 cl-active-block-names))
38e24b8be4ea Improve the lexical scoping in #'block, #'return-from.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5346
diff changeset
717 (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
718 ;; 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
719 ;; 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
720 (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
721 `(catch ',(cdar cl-active-block-names)
5658
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
722 ;; Can't use &environment, since #'block is used in
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
723 ;; #'cl-transform-lambda.
5562
855b667dea13 Drop cl-macro-environment in favour of byte-compile-macro-environment.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5561
diff changeset
724 ,(cl-macroexpand-all body byte-compile-macro-environment))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
725
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
726 ;;;###autoload
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
727 (defmacro return (&optional result)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
728 "Return from the block named nil.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
729 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
730 `(return-from nil ,result))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
731
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
732 ;;;###autoload
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
733 (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
734 "Return from the block named NAME.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
735 This jumps out to the innermost enclosing `(block NAME ...)' form,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
736 returning RESULT from that form (or nil if RESULT is omitted).
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
737 This is compatible with Common Lisp, but note that `defun' and
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
738 `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
739 `(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
740 ;; 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
741 ;; 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
742 (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
743 (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
744 copy-symbol))
4b529b940e2e Eliminate unused blocks named nil, too, cl-macs.el, bytecomp.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5367
diff changeset
745 ,result))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
746
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
747 ;;; The "loop" macro.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
748
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
749 (defvar args) (defvar loop-accum-var) (defvar loop-accum-vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
750 (defvar loop-bindings) (defvar loop-body) (defvar loop-destr-temps)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
751 (defvar loop-finally) (defvar loop-finish-flag) (defvar loop-first-flag)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
752 (defvar loop-initially) (defvar loop-map-form) (defvar loop-name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
753 (defvar loop-result) (defvar loop-result-explicit)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
754 (defvar loop-result-var) (defvar loop-steps) (defvar loop-symbol-macs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
755
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
756 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
757 (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
758 "The Common Lisp `loop' macro.
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
759
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
760 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
761 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
762 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
763 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
764 body repeatedly until an exit condition is hit.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
765
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
766 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
767 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
768 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
769 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
770 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
771 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
772 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
773 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
774 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
775 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
776 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
777
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
778 \(loop
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
779 for x in list
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
780 while x
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
781 do ...)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
782
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
783 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
784 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
785 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
786
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
787 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
788 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
789 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
790 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
791 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
792 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
793 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
794 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
795 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
796 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
797 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
798 `return-from'.)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
799
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
800 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
801 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
802 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
803 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
804 with corresponding elements in the structure. For example:
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
805
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
806 \(loop
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
807 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
808 do (puthash x y some-hash-table))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
809
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
810 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
811 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
812
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
813 \(loop for (x . y) in alist do ...)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
814
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
815 and plists using
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
816
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
817 \(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
818
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
819 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
820 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
821 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
822 most useful feature of `loop'.
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
823
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
824 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
825
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
826 \(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
827 collect (cons x y))
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
828
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
829 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
830 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
831 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
832
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
833 An example of in-place modification is
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
834
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
835 \(setq foo '(1 3 5))
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
836 \(loop for x in-ref foo do
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
837 (setf x (* x x)))
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
838
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
839 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
840
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
841 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
842 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
843
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
844 Valid clauses are:
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
845
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
846 \(NOTE: Keywords in lowercase\; slashes separate different possibilities
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
847 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
848 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
849 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
850 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
851 either `being each foo' or `being the foos'.)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
852
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
853 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
854 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
855 indicate upward stepping\; `downfrom', `downto', and `above' explicitly
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
856 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
857 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
858 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
859 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
860
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
861 for VAR in LIST [by FUNC]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
862 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
863 sublists and defaults to `cdr'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
864
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
865 for VAR on LIST [by FUNC]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
866 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
867 sublists and defaults to `cdr'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
868
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
869 for VAR in-ref LIST [by FUNC]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
870 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
871 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
872 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
873 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
874 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
875 subsequent uses of VAR.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
876
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
877 for VAR = INIT [then EXPR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
878 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
879 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
880 on subsequent ones.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
881
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
882 for VAR across/across-ref ARRAY
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
883 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
884 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
885 `symbol-macrolet' instead of `let' -- see above.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
886
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
887 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
888 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
889 `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
890 `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
891 `let' -- see above.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
892
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
893 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
894
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
895 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
896 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
897 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
898 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
899
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
900 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
901 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
902 currently synonymous.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
903
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
904 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
905 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
906 current buffer, the beginning and the end, respectively.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
907
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
908 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
909 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
910 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
911 respectively. If PROPERTY is given, iteration occurs using
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
912 `next-single-property-change'\; otherwise, using
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
913 `next-property-change'.
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 window/windows [in/of FRAME]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
916 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
917
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
918 for VAR being each/the frame/frames
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
919 Step VAR over all frames.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
920
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
921 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
922 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
923 `for VAR in (buffer-list) [by FUNC]'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
924
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
925 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
926 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
927 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
928 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
929 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
930 (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
931 (third argument of `define-key').
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
932
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
933 as VAR ...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
934 `as' is a synonym for `for'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
935
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
936 and VAR ...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
937 `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
938 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
939 `and'/`for' clause instead of in series.
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 with VAR = INIT
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
942 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
943
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
944 repeat NUM
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
945 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
946
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
947 while COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
948 Exit the loop if COND isn't true.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
949
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
950 until COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
951 Exit the loop if COND is true.
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 collect EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
954 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
955 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
956 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
957 `loop-finish'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
958
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
959 append EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
960 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
961
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
962 nconc EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
963 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
964
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
965 concat EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
966 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
967 `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
968
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
969 vconcat EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
970 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
971 `collect'.
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 bvconcat EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
974 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
975 like `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
976
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
977 sum EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
978 Add EXPR to a value, like `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
979
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
980 count EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
981 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
982
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
983 maximize EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
984 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
985 `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
986
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
987 minimize EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
988 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
989 `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
990
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
991 always COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
992 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
993 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
994 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
995 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
996 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
997
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
998 never COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
999 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
1000 `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
1001 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
1002 iterations of the loop).
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1003
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1004 thereis COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1005 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
1006
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1007 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
1008 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
1009 execute the clauses following `else'.
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 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
1012 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
1013
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1014 do EXPRS...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1015 Execute the expressions (any Lisp forms).
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1016
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1017 initially EXPRS...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1018 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
1019 been set using `with'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1020
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1021 finally EXPRS...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1022 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
1023 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
1024 `never', `thereis', or `return'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1025
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1026 return EXPR
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1027 Exit from the loop and return EXPR.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1028
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1029 finally return EXPR
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1030 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
1031 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
1032 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
1033 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
1034
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1035 named NAME
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1036 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
1037 (See `block'.)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1038 "
5367
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
1039 (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
1040 (list 'block nil (list* 'while t clauses))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1041 (let ((loop-name nil) (loop-bindings nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1042 (loop-body nil) (loop-steps nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1043 (loop-result nil) (loop-result-explicit nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1044 (loop-result-var nil) (loop-finish-flag nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1045 (loop-accum-var nil) (loop-accum-vars nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1046 (loop-initially nil) (loop-finally nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1047 (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
1048 (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
1049 (args (append clauses '(cl-end-loop))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1050 (while (not (eq (car args) 'cl-end-loop)) (cl-parse-loop-clause))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1051 (if loop-finish-flag
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1052 (push (list (list loop-finish-flag t)) loop-bindings))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1053 (if loop-first-flag
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1054 (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
1055 (push (list 'setq loop-first-flag nil) loop-steps)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1056 (let* ((epilogue (nconc (nreverse loop-finally)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1057 (list (or loop-result-explicit loop-result))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1058 (ands (cl-loop-build-ands (nreverse loop-body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1059 (while-body (nconc (cadr ands) (nreverse loop-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1060 (body (append
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1061 (nreverse loop-initially)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1062 (list (if loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1063 (list 'block '--cl-finish--
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1064 (subst
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1065 (if (eq (car ands) t) while-body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1066 (cons (list 'or (car ands)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1067 '(return-from --cl-finish--
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1068 nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1069 while-body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1070 '--cl-map loop-map-form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1071 (list* 'while (car ands) while-body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1072 (if loop-finish-flag
1346
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1073 (if (equal epilogue '(nil))
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1074 ;; XEmacs change: When epilogue is nil and
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1075 ;; 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
1076 ;; warning using the original (commented-out)
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1077 ;; 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
1078 ;; 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
1079 ;; --ben
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1080 ;(list loop-result-var)
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1081 (list (list 'if loop-finish-flag
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1082 loop-result-var loop-result-var))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1083 (list (list 'if loop-finish-flag
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1084 (cons 'progn epilogue) loop-result-var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1085 epilogue))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1086 (if loop-result-var (push (list loop-result-var) loop-bindings))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1087 (while loop-bindings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1088 (if (cdar loop-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1089 (setq body (list (cl-loop-let (pop loop-bindings) body t)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1090 (let ((lets nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1091 (while (and loop-bindings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1092 (not (cdar loop-bindings)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1093 (push (car (pop loop-bindings)) lets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1094 (setq body (list (cl-loop-let lets body nil))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1095 (if loop-symbol-macs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1096 (setq body (list (list* 'symbol-macrolet loop-symbol-macs body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1097 (list* 'block loop-name body)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1098
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1099 (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
1100 (let ((word (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1101 (hash-types '(hash-key hash-keys hash-value hash-values))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1102 (key-types '(key-code key-codes key-seq key-seqs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1103 key-binding key-bindings)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1104 (cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1105
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1106 ((null args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1107 (error "Malformed `loop' macro"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1108
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1109 ((eq word 'named)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1110 (setq loop-name (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1111
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1112 ((eq word 'initially)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1113 (if (memq (car args) '(do doing)) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1114 (or (consp (car args)) (error "Syntax error on `initially' clause"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1115 (while (consp (car args))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1116 (push (pop args) loop-initially)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1117
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1118 ((eq word 'finally)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1119 (if (eq (car args) 'return)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1120 (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
1121 (if (memq (car args) '(do doing)) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1122 (or (consp (car args)) (error "Syntax error on `finally' clause"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1123 (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
1124 (setq loop-result-explicit (or (nth 1 (pop args)) '(quote nil)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1125 (while (consp (car args))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1126 (push (pop args) loop-finally)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1127
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1128 ((memq word '(for as))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1129 (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
1130 (ands nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1131 (while
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1132 (let ((var (or (pop args) (gensym))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1133 (setq word (pop args))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1134 (if (eq word 'being) (setq word (pop args)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1135 (if (memq word '(the each)) (setq word (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1136 (if (memq word '(buffer buffers))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1137 (setq word 'in args (cons '(buffer-list) args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1138 (cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1139
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1140 ((memq word '(from downfrom upfrom to downto upto
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1141 above below by))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1142 (push word args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1143 (if (memq (car args) '(downto above))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1144 (error "Must specify `from' value for downward loop"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1145 (let* ((down (or (eq (car args) 'downfrom)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1146 (memq (caddr args) '(downto above))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1147 (excl (or (memq (car args) '(above below))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1148 (memq (caddr args) '(above below))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1149 (start (and (memq (car args) '(from upfrom downfrom))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1150 (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1151 (end (and (memq (car args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1152 '(to upto downto above below))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1153 (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1154 (step (and (eq (car args) 'by) (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1155 (end-var (and (not (cl-const-expr-p end)) (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1156 (step-var (and (not (cl-const-expr-p step))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1157 (gensym))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1158 (and step (numberp step) (<= step 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1159 (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
1160 (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
1161 (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
1162 (if step-var (push (list step-var step)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1163 loop-for-bindings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1164 (if end
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1165 (push (list
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1166 (if down (if excl '> '>=) (if excl '< '<=))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1167 var (or end-var end)) loop-body))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1168 (push (list var (list (if down '- '+) var
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1169 (or step-var step 1)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1170 loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1171
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1172 ((memq word '(in in-ref on))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1173 (let* ((on (eq word 'on))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1174 (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
1175 (push (list temp (pop args)) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1176 (push (list 'consp temp) loop-body)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1177 (if (eq word 'in-ref)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1178 (push (list var (list 'car temp)) loop-symbol-macs)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1179 (or (eq temp var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1180 (progn
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1181 (push (list var nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1182 (push (list var (if on temp (list 'car temp)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1183 loop-for-sets))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1184 (push (list temp
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1185 (if (eq (car args) 'by)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1186 (let ((step (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1187 (if (and (memq (car-safe step)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1188 '(quote function
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1189 function*))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1190 (symbolp (nth 1 step)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1191 (list (nth 1 step) temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1192 (list 'funcall step temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1193 (list 'cdr temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1194 loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1195
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1196 ((eq word '=)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1197 (let* ((start (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1198 (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
1199 (push (list var nil) loop-for-bindings)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1200 (if (or ands (eq (car args) 'and))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1201 (progn
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1202 (push (list var
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1203 (list 'if
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1204 (or loop-first-flag
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1205 (setq loop-first-flag
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1206 (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1207 start var))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1208 loop-for-sets)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1209 (push (list var then) loop-for-steps))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1210 (push (list var
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1211 (if (eq start then) start
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1212 (list 'if
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1213 (or loop-first-flag
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1214 (setq loop-first-flag (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1215 start then)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1216 loop-for-sets))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1217
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1218 ((memq word '(across across-ref))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1219 (let ((temp-vec (gensym)) (temp-idx (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1220 (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
1221 (push (list temp-idx -1) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1222 (push (list '< (list 'setq temp-idx (list '1+ temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1223 (list 'length temp-vec)) loop-body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1224 (if (eq word 'across-ref)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1225 (push (list var (list 'aref temp-vec temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1226 loop-symbol-macs)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1227 (push (list var nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1228 (push (list var (list 'aref temp-vec temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1229 loop-for-sets))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1230
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1231 ((memq word '(element elements))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1232 (let ((ref (or (memq (car args) '(in-ref of-ref))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1233 (and (not (memq (car args) '(in of)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1234 (error "Expected `of'"))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1235 (seq (cl-pop2 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1236 (temp-seq (gensym))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1237 (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
1238 (if (and (eql (length (cadr args)) 2)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1239 (eq (caadr args) 'index))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1240 (cadr (cl-pop2 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1241 (error "Bad `using' clause"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1242 (gensym))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1243 (push (list temp-seq seq) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1244 (push (list temp-idx 0) loop-for-bindings)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1245 (if ref
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1246 (let ((temp-len (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1247 (push (list temp-len (list 'length temp-seq))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1248 loop-for-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1249 (push (list var (list 'elt temp-seq temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1250 loop-symbol-macs)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1251 (push (list '< temp-idx temp-len) loop-body))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1252 (push (list var nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1253 (push (list 'and temp-seq
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1254 (list 'or (list 'consp temp-seq)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1255 (list '< temp-idx
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1256 (list 'length temp-seq))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1257 loop-body)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1258 (push (list var (list 'if (list 'consp temp-seq)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1259 (list 'pop temp-seq)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1260 (list 'aref temp-seq temp-idx)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1261 loop-for-sets))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1262 (push (list temp-idx (list '1+ temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1263 loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1264
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1265 ((memq word hash-types)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1266 (or (memq (car args) '(in of)) (error "Expected `of'"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1267 (let* ((table (cl-pop2 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1268 (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
1269 (if (and (eql (length (cadr args)) 2)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1270 (memq (caadr args) hash-types)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1271 (not (eq (caadr args) word)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1272 (cadr (cl-pop2 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1273 (error "Bad `using' clause"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1274 (gensym))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1275 (if (memq word '(hash-value hash-values))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1276 (setq var (prog1 other (setq other var))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1277 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1278 (list 'maphash (list 'function
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1279 (list* 'lambda (list var other)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1280 '--cl-map)) table))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1281
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1282 ((memq word '(symbol present-symbol external-symbol
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1283 symbols present-symbols external-symbols))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1284 (let ((ob (and (memq (car args) '(in of)) (cl-pop2 args))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1285 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1286 (list 'mapatoms (list 'function
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1287 (list* 'lambda (list var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1288 '--cl-map)) ob))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1289
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1290 ((memq word '(overlay overlays extent extents))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1291 (let ((buf nil) (from nil) (to nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1292 (while (memq (car args) '(in of from to))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1293 (cond ((eq (car args) 'from) (setq from (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1294 ((eq (car args) 'to) (setq to (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1295 (t (setq buf (cl-pop2 args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1296 (setq loop-map-form
5632
bd80d9103fc8 Integrate CL code better into core, remove obsolete compatibility code.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5624
diff changeset
1297 (list 'map-extents
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1298 (list 'function (list 'lambda (list var (gensym))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1299 '(progn . --cl-map) nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1300 buf from to))))
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 '(interval intervals))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1303 (let ((buf nil) (prop nil) (from nil) (to nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1304 (var1 (gensym)) (var2 (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1305 (while (memq (car args) '(in of property from to))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1306 (cond ((eq (car args) 'from) (setq from (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1307 ((eq (car args) 'to) (setq to (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1308 ((eq (car args) 'property)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1309 (setq prop (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1310 (t (setq buf (cl-pop2 args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1311 (if (and (consp var) (symbolp (car var)) (symbolp (cdr var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1312 (setq var1 (car var) var2 (cdr var))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1313 (push (list var (list 'cons var1 var2)) loop-for-sets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1314 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1315 (list 'cl-map-intervals
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1316 (list 'function (list 'lambda (list var1 var2)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1317 '(progn . --cl-map)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1318 buf prop from to))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1319
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1320 ((memq word key-types)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1321 (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
1322 (let* ((map (cl-pop2 args))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1323 other-word
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1324 (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
1325 (if (and (eql (length (cadr args)) 2)
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1326 (memq (setq other-word (caadr args))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1327 key-types)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1328 (not (eq (caadr args) word)))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1329 (cadr (cl-pop2 args))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1330 (error "Bad `using' clause"))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1331 (gensym))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1332 ;; XEmacs addition: track other-word
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1333 (when (memq word '(key-binding key-bindings))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1334 (setq var (prog1 other (setq other var)))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1335 (and other-word (setq word other-word)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1336 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1337 (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
1338 'cl-map-keymap-recursively 'map-keymap)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1339 (list 'function (list* 'lambda (list var other)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1340 '--cl-map)) map))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1341
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1342 ((memq word '(frame frames screen screens))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1343 (let ((temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1344 (push (list var '(selected-frame))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1345 loop-for-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1346 (push (list temp nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1347 (push (list 'prog1 (list 'not (list 'eq var temp))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1348 (list 'or temp (list 'setq temp var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1349 loop-body)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1350 (push (list var (list 'next-frame var))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1351 loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1352
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1353 ((memq word '(window windows))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1354 (let ((scr (and (memq (car args) '(in of)) (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1355 (temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1356 (push (list var (if scr
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1357 (list 'frame-selected-window scr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1358 '(selected-window)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1359 loop-for-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1360 (push (list temp nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1361 (push (list 'prog1 (list 'not (list 'eq var temp))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1362 (list 'or temp (list 'setq temp var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1363 loop-body)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1364 (push (list var (list 'next-window var)) loop-for-steps)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1365
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1366 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1367 (let ((handler (and (symbolp word)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1368 (get word 'cl-loop-for-handler))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1369 (if handler
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1370 (funcall handler var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1371 (error "Expected a `for' preposition, found %s" word)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1372 (eq (car args) 'and))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1373 (setq ands t)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1374 (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1375 (if (and ands loop-for-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1376 (push (nreverse loop-for-bindings) loop-bindings)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1377 (setq loop-bindings (nconc (mapcar 'list loop-for-bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1378 loop-bindings)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1379 (if loop-for-sets
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1380 (push (list 'progn
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1381 (cl-loop-let (nreverse loop-for-sets) 'setq ands)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1382 t) loop-body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1383 (if loop-for-steps
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1384 (push (cons (if ands 'psetq 'setq)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1385 (apply 'append (nreverse loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1386 loop-steps))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1387
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1388 ((eq word 'repeat)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1389 (let ((temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1390 (push (list (list temp (pop args))) loop-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1391 (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
1392
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1393 ((memq word '(collect collecting))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1394 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1395 (var (cl-loop-handle-accum nil 'nreverse)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1396 (if (eq var loop-accum-var)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1397 (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
1398 (push (list 'progn
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1399 (list 'setq var (list 'nconc var (list 'list what)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1400 t) loop-body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1401
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1402 ((memq word '(nconc nconcing append appending))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1403 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1404 (var (cl-loop-handle-accum nil 'nreverse)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1405 (push (list 'progn
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1406 (list 'setq var
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1407 (if (eq var loop-accum-var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1408 (list 'nconc
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1409 (list (if (memq word '(nconc nconcing))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1410 'nreverse 'reverse)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1411 what)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1412 var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1413 (list (if (memq word '(nconc nconcing))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1414 'nconc 'append)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1415 var what))) t) loop-body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1416
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1417 ((memq word '(concat concating))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1418 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1419 (var (cl-loop-handle-accum "")))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1420 (push (list 'progn (list 'callf 'concat var what) t) loop-body)))
428
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 '(vconcat vconcating))
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 [])))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1425 (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
1426
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1427 ;; XEmacs addition: handle bit-vectors
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1428 ((memq word '(bvconcat bvconcating))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1429 (let ((what (pop args))
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1430 (var (cl-loop-handle-accum #*)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1431 (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
1432
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1433 ((memq word '(sum summing))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1434 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1435 (var (cl-loop-handle-accum 0)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1436 (push (list 'progn (list 'incf var what) t) loop-body)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1437
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1438 ((memq word '(count counting))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1439 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1440 (var (cl-loop-handle-accum 0)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1441 (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
1442
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1443 ((memq word '(minimize minimizing maximize maximizing))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1444 (let* ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1445 (temp (if (cl-simple-expr-p what) what (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1446 (var (cl-loop-handle-accum nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1447 (func (intern (substring (symbol-name word) 0 3)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1448 (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
1449 (push (list 'progn (if (eq temp what) set
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1450 (list 'let (list (list temp what)) set))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1451 t) loop-body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1452
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1453 ((eq word 'with)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1454 (let ((bindings nil))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1455 (while (progn (push (list (pop args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1456 (and (eq (car args) '=) (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1457 bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1458 (eq (car args) 'and))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1459 (pop args))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1460 (push (nreverse bindings) loop-bindings)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1461
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1462 ((eq word 'while)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1463 (push (pop args) loop-body))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1464
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1465 ((eq word 'until)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1466 (push (list 'not (pop args)) loop-body))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1467
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1468 ((eq word 'always)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1469 (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
1470 (push (list 'setq loop-finish-flag (pop args)) loop-body)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1471 (setq loop-result t))
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 'never)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1474 (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
1475 (push (list 'setq loop-finish-flag (list 'not (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1476 loop-body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1477 (setq loop-result t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1478
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1479 ((eq word 'thereis)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1480 (or loop-finish-flag (setq loop-finish-flag (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1481 (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
1482 (push (list 'setq loop-finish-flag
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1483 (list 'not (list 'setq loop-result-var (pop args))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1484 loop-body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1485
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1486 ((memq word '(if when unless))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1487 (let* ((cond (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1488 (then (let ((loop-body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1489 (cl-parse-loop-clause)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1490 (cl-loop-build-ands (nreverse loop-body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1491 (else (let ((loop-body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1492 (if (eq (car args) 'else)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1493 (progn (pop args) (cl-parse-loop-clause)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1494 (cl-loop-build-ands (nreverse loop-body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1495 (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
1496 (if (eq (car args) 'end) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1497 (if (eq word 'unless) (setq then (prog1 else (setq else then))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1498 (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
1499 (if simple (nth 1 else) (list (nth 2 else))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1500 (if (cl-expr-contains form 'it)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1501 (let ((temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1502 (push (list temp) loop-bindings)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1503 (setq form (list* 'if (list 'setq temp cond)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1504 (subst temp 'it form))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1505 (setq form (list* 'if cond form)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1506 (push (if simple (list 'progn form t) form) loop-body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1507
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1508 ((memq word '(do doing))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1509 (let ((body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1510 (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
1511 (while (consp (car args)) (push (pop args) body))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1512 (push (cons 'progn (nreverse (cons t body))) loop-body)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1513
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1514 ((eq word 'return)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1515 (or loop-finish-flag (setq loop-finish-flag (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1516 (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
1517 (push (list 'setq loop-result-var (pop args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1518 loop-finish-flag nil) loop-body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1519
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1520 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1521 (let ((handler (and (symbolp word) (get word 'cl-loop-handler))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1522 (or handler (error "Expected a loop keyword, found %s" word))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1523 (funcall handler))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1524 (if (eq (car args) 'and)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1525 (progn (pop args) (cl-parse-loop-clause)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1526
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1527 (defun cl-loop-let (specs body par) ; uses loop-*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1528 (let ((p specs) (temps nil) (new nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1529 (while (and p (or (symbolp (car-safe (car p))) (null (cadar p))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1530 (setq p (cdr p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1531 (and par p
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1532 (progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1533 (setq par nil p specs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1534 (while p
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1535 (or (cl-const-expr-p (cadar p))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1536 (let ((temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1537 (push (list temp (cadar p)) temps)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1538 (setcar (cdar p) temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1539 (setq p (cdr p)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1540 (while specs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1541 (if (and (consp (car specs)) (listp (caar specs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1542 (let* ((spec (caar specs)) (nspecs nil)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1543 (expr (cadr (pop specs)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1544 (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
1545 (car (push (cons spec (or (last spec 0)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1546 (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1547 loop-destr-temps))))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1548 (push (list temp expr) new)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1549 (while (consp spec)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1550 (push (list (pop spec)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1551 (and expr (list (if spec 'pop 'car) temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1552 nspecs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1553 (setq specs (nconc (nreverse nspecs) specs)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1554 (push (pop specs) new)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1555 (if (eq body 'setq)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1556 (let ((set (cons (if par 'psetq 'setq) (apply 'nconc (nreverse new)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1557 (if temps (list 'let* (nreverse temps) set) set))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1558 (list* (if par 'let 'let*)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1559 (nconc (nreverse temps) (nreverse new)) body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1560
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1561 (defun cl-loop-handle-accum (def &optional func) ; uses args, loop-*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1562 (if (eq (car args) 'into)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1563 (let ((var (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1564 (or (memq var loop-accum-vars)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1565 (progn (push (list (list var def)) loop-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1566 (push var loop-accum-vars)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1567 var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1568 (or loop-accum-var
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1569 (progn
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1570 (push (list (list (setq loop-accum-var (gensym)) def))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1571 loop-bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1572 (setq loop-result (if func (list func loop-accum-var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1573 loop-accum-var))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1574 loop-accum-var))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1575
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1576 (defun cl-loop-build-ands (clauses)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1577 (let ((ands nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1578 (body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1579 (while clauses
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1580 (if (and (eq (car-safe (car clauses)) 'progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1581 (eq (car (last (car clauses))) t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1582 (if (cdr clauses)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1583 (setq clauses (cons (nconc (butlast (car clauses))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1584 (if (eq (car-safe (cadr clauses))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1585 'progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1586 (cdadr clauses)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1587 (list (cadr clauses))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1588 (cddr clauses)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1589 (setq body (cdr (butlast (pop clauses)))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1590 (push (pop clauses) ands)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1591 (setq ands (or (nreverse ands) (list t)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1592 (list (if (cdr ands) (cons 'and ands) (car ands))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1593 body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1594 (let ((full (if body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1595 (append ands (list (cons 'progn (append body '(t)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1596 ands)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1597 (if (cdr full) (cons 'and full) (car full))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1598
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1599
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1600 ;;; Other iteration control structures.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1601
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1602 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1603 (defmacro do (steps endtest &rest body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1604 "The Common Lisp `do' loop.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1605 Format is: (do ((VAR INIT [STEP])...) (END-TEST [RESULT...]) BODY...)"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1606 (cl-expand-do-loop steps endtest body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1607
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1608 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1609 (defmacro do* (steps endtest &rest body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1610 "The Common Lisp `do*' loop.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1611 Format is: (do* ((VAR INIT [STEP])...) (END-TEST [RESULT...]) BODY...)"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1612 (cl-expand-do-loop steps endtest body t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1613
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1614 (defun cl-expand-do-loop (steps endtest body star)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1615 (list 'block nil
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1616 (list* (if star 'let* 'let)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1617 (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
1618 steps)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1619 (list* 'while (list 'not (car endtest))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1620 (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
1621 (let ((sets (mapcan
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1622 #'(lambda (c)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1623 (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
1624 (list
8b70d37ab80e Use Common Lisp-derived builtins in a few more places in core Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5366
diff changeset
1625 (list (car c) (nth 2 c)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1626 steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1627 (and sets
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1628 (list (cons (if (or star (not (cdr sets)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1629 'setq 'psetq)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1630 (apply 'append sets)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1631 (or (cdr endtest) '(nil)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1632
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1633 ;;;###autoload
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1634 (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
1635 "Loop over a list.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1636 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
1637 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
1638 (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
1639 `(block nil
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1640 (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
1641 (while ,gensym
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1642 (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
1643 ,@body
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1644 (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
1645 ,@(if result `((setq ,var nil) ,result))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1646
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1647 ;;;###autoload
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1648 (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
1649 "Loop a certain number of times.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1650 Evaluate BODY with VAR bound to successive integers from 0, inclusive,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1651 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
1652 nil."
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1653 (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
1654 (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
1655 `(block nil
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1656 (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
1657 (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
1658 ,@body
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1659 (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
1660 ,@(if result (list result))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1661
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1662 ;;;###autoload
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1663 (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
1664 "Loop over all interned symbols.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1665 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
1666 from OBARRAY."
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1667 `(block nil
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1668 (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
1669 ,@(if result `((let (,var) ,result)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1670
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1671 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1672 (defmacro do-all-symbols (spec &rest body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1673 (list* 'do-symbols (list (car spec) nil (cadr spec)) body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1674
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1675
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1676 ;;; Assignments.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1677
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1678 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1679 (defmacro psetq (&rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1680 "(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
1681 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
1682 before assigning any symbols SYM to the corresponding values."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1683 (cons 'psetf args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1684
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1685
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1686 ;;; Binding control structures.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1687
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1688 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1689 (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
1690 "Bind SYMBOLS to VALUES dynamically in BODY.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1691 The forms SYMBOLS and VALUES are evaluated, and must evaluate to lists.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1692 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
1693 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
1694 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
1695 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
1696 (list 'let '((cl-progv-save nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1697 (list 'unwind-protect
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1698 (list* 'progn (list 'cl-progv-before symbols values) body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1699 '(cl-progv-after))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1700
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1701 ;;;###autoload
5658
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
1702 (defmacro* macrolet ((&rest macros) &body form &environment env)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1703 "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
1704 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
1705 (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
1706 (nconc
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1707 (loop
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1708 for (name . details)
5511
7b5254f6e0d5 Fix CL compliance of [symbol-]macrolet.
Didier Verna <didier@xemacs.org>
parents: 5509
diff changeset
1709 in macros
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1710 collect
5509
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
1711 (list* name 'lambda (cdr (cl-transform-lambda details
9ac0016d8fe8 Remove `bind-inits', cl-macs.el, it's no longer used.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5501
diff changeset
1712 name))))
5658
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
1713 env)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1714
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1715 ;;;###autoload
5658
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
1716 (defmacro* symbol-macrolet ((&rest symbol-macros) &body form &environment env)
5511
7b5254f6e0d5 Fix CL compliance of [symbol-]macrolet.
Didier Verna <didier@xemacs.org>
parents: 5509
diff changeset
1717 "Make temporary symbol macro definitions.
7b5254f6e0d5 Fix CL compliance of [symbol-]macrolet.
Didier Verna <didier@xemacs.org>
parents: 5509
diff changeset
1718 Elements in SYMBOL-MACROS look like (NAME EXPANSION).
7b5254f6e0d5 Fix CL compliance of [symbol-]macrolet.
Didier Verna <didier@xemacs.org>
parents: 5509
diff changeset
1719 Within the body FORMs, a reference to NAME is replaced with its EXPANSION,
7b5254f6e0d5 Fix CL compliance of [symbol-]macrolet.
Didier Verna <didier@xemacs.org>
parents: 5509
diff changeset
1720 and (setq NAME ...) acts like (setf EXPANSION ...)."
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1721 (cl-macroexpand-all (cons 'progn form)
5511
7b5254f6e0d5 Fix CL compliance of [symbol-]macrolet.
Didier Verna <didier@xemacs.org>
parents: 5509
diff changeset
1722 (nconc (loop
5462
97ac18bd1fa3 Make sure distinct symbol macros with identical names expand distinctly.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5391
diff changeset
1723 for (name expansion) in symbol-macros
97ac18bd1fa3 Make sure distinct symbol macros with identical names expand distinctly.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5391
diff changeset
1724 do (check-type name symbol)
97ac18bd1fa3 Make sure distinct symbol macros with identical names expand distinctly.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5391
diff changeset
1725 collect (list (eq-hash name) expansion))
5658
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
1726 env)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1727
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1728 (defvar cl-closure-vars nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1729 ;;;###autoload
5658
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
1730 (defmacro* lexical-let (bindings &rest body &environment env)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
1731 "Like `let', but lexically scoped.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1732 The main visible difference is that lambdas inside BODY will create
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1733 lexical closures as in Common Lisp."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1734 (let* ((cl-closure-vars cl-closure-vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1735 (vars (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1736 (or (consp x) (setq x (list x)))
5462
97ac18bd1fa3 Make sure distinct symbol macros with identical names expand distinctly.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5391
diff changeset
1737 (push (gensym (concat "--" (symbol-name (car x))
97ac18bd1fa3 Make sure distinct symbol macros with identical names expand distinctly.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5391
diff changeset
1738 "--" ))
97ac18bd1fa3 Make sure distinct symbol macros with identical names expand distinctly.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5391
diff changeset
1739 cl-closure-vars)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1740 (set (car cl-closure-vars) [bad-lexical-ref])
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1741 (list (car x) (cadr x) (car cl-closure-vars)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1742 bindings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1743 (ebody
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1744 (cl-macroexpand-all
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1745 (cons 'progn body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1746 (nconc (mapcar #'(lambda (x)
5462
97ac18bd1fa3 Make sure distinct symbol macros with identical names expand distinctly.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5391
diff changeset
1747 (list (eq-hash (car x))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1748 (list 'symbol-value (caddr x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1749 t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1750 vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1751 (list '(defun . cl-defun-expander))
5658
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
1752 env))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1753 (if (not (get (car (last cl-closure-vars)) 'used))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1754 (list 'let (mapcar #'(lambda (x) (list (caddr x) (cadr x))) vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1755 (sublis (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1756 (cons (caddr x) (list 'quote (caddr x))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1757 vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1758 ebody))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1759 (list 'let (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1760 (list (caddr x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1761 (list 'make-symbol
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1762 (format "--%s--" (car x)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1763 vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1764 (apply 'append '(setf)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1765 (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1766 (list (list 'symbol-value (caddr x)) (cadr x)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1767 vars))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1768 ebody))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1769
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1770 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1771 (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
1772 "Like `let*', but lexically scoped.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1773 The main visible difference is that lambdas inside BODY will create
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1774 lexical closures as in Common Lisp."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1775 (if (null bindings) (cons 'progn body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1776 (setq bindings (reverse bindings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1777 (while bindings
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1778 (setq body (list (list* 'lexical-let (list (pop bindings)) body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1779 (car body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1780
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1781 (defun cl-defun-expander (func &rest rest)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1782 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1783 (list 'defalias (list 'quote func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1784 (list 'function (cons 'lambda rest)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1785 (list 'quote func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1786
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1787 ;;; Multiple values. We support full Common Lisp conventions here.
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
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1790 (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
1791 "Collect and bind multiple return values.
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1792
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1793 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
1794 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
1795 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
1796 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
1797
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1798 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
1799 (if (null syms)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1800 `(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
1801 (if (eql 1 (length syms))
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1802 ;; 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
1803 ;; 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
1804 `(let ((,(car syms) ,form))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1805 ,@body)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1806 (let ((temp (gensym)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1807 `(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
1808 ,@(loop
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1809 for var in syms
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1810 collect `(,var (prog1 (car ,temp)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1811 (setq ,temp (cdr ,temp))))))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1812 ,@body)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1813
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1814 ;;;###autoload
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1815 (defmacro multiple-value-setq (syms form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1816 "Collect and set multiple values.
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1817
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1818 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
1819 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
1820 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
1821 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
1822 of SYMS initialized to nil.
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1823
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1824 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
1825 (if (null syms)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1826 ;; 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
1827 (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
1828 (if (eql 1 (length syms))
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1829 `(setq ,(car syms) ,form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1830 (let ((temp (gensym)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1831 `(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
1832 (setq ,@(loop
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1833 for sym in syms
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1834 nconc `(,sym (car-safe ,temp)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1835 ,temp (cdr-safe ,temp))))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1836 ,(car syms))))))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1837
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1838 ;;;###autoload
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1839 (defmacro multiple-value-list (form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1840 "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
1841 `(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
1842
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1843 ;;;###autoload
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1844 (defmacro nth-value (n form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1845 "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
1846 (if (integerp n)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1847 `(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
1848 (let ((temp (gensym)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1849 `(let ((,temp ,n))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1850 (car (multiple-value-list-internal ,temp (1+ ,temp) ,form))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1851
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1852 ;;; Declarations.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1853
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1854 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1855 (defmacro locally (&rest body) (cons 'progn body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1856
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1857 (defvar cl-proclaim-history t) ; for future compilers
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1858 (defvar cl-declare-stack t) ; for future compilers
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1859
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1860 (defun cl-do-proclaim (spec hist)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1861 (and hist (listp cl-proclaim-history) (push spec cl-proclaim-history))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1862 (cond ((eq (car-safe spec) 'special)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1863 (if (boundp 'byte-compile-bound-variables)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1864 (setq byte-compile-bound-variables
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
1865 (append
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1866 ;; XEmacs change
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
1867 (mapcar #'(lambda (v) (cons v byte-compile-global-bit))
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
1868 (cdr spec))
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
1869 byte-compile-bound-variables))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1870
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1871 ((eq (car-safe spec) 'inline)
5656
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1872 (while (setq spec (cdr spec))
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1873 (let* ((assq (cdr (assq (car spec)
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1874 byte-compile-macro-environment)))
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1875 (symbol (if (and (consp assq)
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1876 (eq (nth 1 (nth 1 assq))
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1877 'byte-compile-labels-args))
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1878 ;; It's a label, and we're using the labels
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1879 ;; implementation in bytecomp.el. Tell the
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1880 ;; compiler to inline it, don't mark the
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1881 ;; symbol to be inlined globally.
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1882 (nth 1 (nth 1 (nth 3 assq)))
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1883 (car spec))))
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1884 (or (memq (get symbol 'byte-optimizer)
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1885 '(nil byte-compile-inline-expand))
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1886 (error
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1887 "%s already has a byte-optimizer, can't make it inline"
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1888 symbol))
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1889 (put symbol 'byte-optimizer 'byte-compile-inline-expand))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1890 ((eq (car-safe spec) 'notinline)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1891 (while (setq spec (cdr spec))
5656
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1892 (let* ((assq (cdr (assq (car spec)
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1893 byte-compile-macro-environment)))
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1894 (symbol (if (and (consp assq)
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1895 (eq (nth 1 (nth 1 assq))
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1896 'byte-compile-labels-args))
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1897 ;; It's a label, and we're using the labels
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1898 ;; implementation in bytecomp.el. Tell the
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1899 ;; compiler not to inline it, don't mark the
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1900 ;; symbol to be notinline globally.
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1901 (nth 1 (nth 1 (nth 3 assq)))
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1902 (car spec))))
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1903 (if (eq (get symbol 'byte-optimizer)
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1904 'byte-compile-inline-expand)
e9c3fe82127d Co-operate with the byte-optimizer in the bytecomp.el labels implementation.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5652
diff changeset
1905 (put symbol 'byte-optimizer nil)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1906 ((eq (car-safe spec) 'optimize)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1907 (let ((speed (assq (nth 1 (assq 'speed (cdr spec)))
446
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1908 '((0 . nil) (1 . t) (2 . t) (3 . t))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1909 (safety (assq (nth 1 (assq 'safety (cdr spec)))
446
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1910 '((0 . t) (1 . t) (2 . t) (3 . nil)))))
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1911 (when speed
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1912 (setq cl-optimize-speed (car speed)
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1913 byte-optimize (cdr speed)))
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1914 (when safety
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1915 (setq cl-optimize-safety (car safety)
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
1916 byte-compile-delete-errors (cdr safety)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1917
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1918 ((and (eq (car-safe spec) 'warn) (boundp 'byte-compile-warnings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1919 (if (eq byte-compile-warnings t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1920 ;; XEmacs change
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1921 (setq byte-compile-warnings byte-compile-default-warnings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1922 (while (setq spec (cdr spec))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1923 (if (consp (car spec))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1924 (if (eq (cadar spec) 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1925 (setq byte-compile-warnings
5652
cc6f0266bc36 Avoid #'delq in core Lisp, for the sake of style, a very slightly smaller binary
Aidan Kehoe <kehoea@parhasard.net>
parents: 5651
diff changeset
1926 (delete* (caar spec) byte-compile-warnings))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1927 (setq byte-compile-warnings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1928 (adjoin (caar spec) byte-compile-warnings)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1929 nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1930
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1931 ;;; Process any proclamations made before cl-macs was loaded.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1932 (defvar cl-proclaims-deferred)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1933 (let ((p (reverse cl-proclaims-deferred)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1934 (while p (cl-do-proclaim (pop p) t))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1935 (setq cl-proclaims-deferred nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1936
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1937 ;;; Generalized variables.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1938
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1939 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1940 (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
1941 "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
1942 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
1943 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
1944 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
1945 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
1946 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
1947 form. See `defsetf' for a simpler way to define most setf-methods."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1948 (append '(eval-when (compile load eval))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1949 (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
1950 (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
1951 (pop body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1952 (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
1953 name 'setf-method (cons arglist body)))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1954 (defalias 'define-setf-expander 'define-setf-method)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1955
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1956 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1957 (defmacro defsetf (func arg1 &rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1958 "(defsetf NAME FUNC): define a `setf' method.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1959 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
1960 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
1961 the form (setf (NAME ARGS...) VAL) are transformed to function or macro
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1962 calls of the form (FUNC ARGS... VAL). Example: (defsetf aref aset).
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1963 Alternate form: (defsetf NAME ARGLIST (STORE) BODY...).
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1964 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
1965 according to ARGLIST, binding the value form VAL to STORE, then executing
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1966 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
1967 Actually, ARGLIST and STORE may be bound to temporary variables which are
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1968 introduced automatically to preserve proper execution order of the arguments.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1969 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
1970 (if (listp arg1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1971 (let* ((largs nil) (largsr nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1972 (temps nil) (tempsr nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1973 (restarg nil) (rest-temps nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1974 (store-var (car (prog1 (car args) (setq args (cdr args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1975 (store-temp (intern (format "--%s--temp--" store-var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1976 (lets1 nil) (lets2 nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1977 (docstr nil) (p arg1))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1978 (if (stringp (car args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1979 (setq docstr (prog1 (car args) (setq args (cdr args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1980 (while (and p (not (eq (car p) '&aux)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1981 (if (eq (car p) '&rest)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1982 (setq p (cdr p) restarg (car p))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1983 (or (memq (car p) '(&optional &key &allow-other-keys))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1984 (setq largs (cons (if (consp (car p)) (car (car p)) (car p))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1985 largs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1986 temps (cons (intern (format "--%s--temp--" (car largs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1987 temps))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1988 (setq p (cdr p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1989 (setq largs (nreverse largs) temps (nreverse temps))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1990 (if restarg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1991 (setq largsr (append largs (list restarg))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1992 rest-temps (intern (format "--%s--temp--" restarg))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1993 tempsr (append temps (list rest-temps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1994 (setq largsr largs tempsr temps))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1995 (let ((p1 largs) (p2 temps))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1996 (while p1
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1997 (setq lets1 (cons (list (car p2)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1998 (list 'gensym (format "--%s--" (car p1))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1999 lets1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2000 lets2 (cons (list (car p1) (car p2)) lets2)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2001 p1 (cdr p1) p2 (cdr p2))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2002 (if restarg (setq lets2 (cons (list restarg rest-temps) lets2)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2003 (append (list 'define-setf-method func arg1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2004 (and docstr (list docstr))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2005 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2006 (list 'let*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2007 (nreverse
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2008 (cons (list store-temp
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2009 (list 'gensym (format "--%s--" store-var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2010 (if restarg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2011 (append
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2012 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2013 (list rest-temps
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2014 (list 'mapcar '(quote gensym)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2015 restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2016 lets1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2017 lets1)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2018 (list 'list ; 'values
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2019 (cons (if restarg 'list* 'list) tempsr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2020 (cons (if restarg 'list* 'list) largsr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2021 (list 'list store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2022 (cons 'let*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2023 (cons (nreverse
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2024 (cons (list store-var store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2025 lets2))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2026 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2027 (cons (if restarg 'list* 'list)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2028 (cons (list 'quote func) tempsr)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2029 (list 'defsetf func '(&rest args) '(store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2030 (let ((call (list 'cons (list 'quote arg1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2031 '(append args (list store)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2032 (if (car args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2033 (list 'list '(quote progn) call 'store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2034 call)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2035
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2036 ;;; Some standard place types from Common Lisp.
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2037 (eval-when-compile (defvar ignored-arg)) ; XEmacs: warning suppression
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2038 (defsetf aref aset)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2039 (defsetf car setcar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2040 (defsetf cdr setcdr)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2041 (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
2042 (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
2043 (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
2044 (defsetf cddr (x) (val) (list 'setcdr (list 'cdr x) val))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2045 (defsetf elt (seq n) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2046 (list 'if (list 'listp seq) (list 'setcar (list 'nthcdr n seq) store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2047 (list 'aset seq n store)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2048 ;; XEmacs change: ignore the optional DEFAULT arguments
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2049 (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
2050 (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
2051 (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
2052 (defsetf nth (n x) (store) (list 'setcar (list 'nthcdr n x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2053 (defsetf subseq (seq start &optional end) (new)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2054 (list 'progn (list 'replace seq new :start1 start :end1 end) new))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2055 (defsetf symbol-function fset)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2056 (defsetf symbol-plist setplist)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2057 (defsetf symbol-value set)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2058
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2059 ;;; Various car/cdr aliases. Note that `cadr' is handled specially.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2060 (defsetf first setcar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2061 (defsetf second (x) (store) (list 'setcar (list 'cdr x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2062 (defsetf third (x) (store) (list 'setcar (list 'cddr x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2063 (defsetf fourth (x) (store) (list 'setcar (list 'cdddr x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2064 (defsetf fifth (x) (store) (list 'setcar (list 'nthcdr 4 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2065 (defsetf sixth (x) (store) (list 'setcar (list 'nthcdr 5 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2066 (defsetf seventh (x) (store) (list 'setcar (list 'nthcdr 6 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2067 (defsetf eighth (x) (store) (list 'setcar (list 'nthcdr 7 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2068 (defsetf ninth (x) (store) (list 'setcar (list 'nthcdr 8 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2069 (defsetf tenth (x) (store) (list 'setcar (list 'nthcdr 9 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2070 (defsetf rest setcdr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2071
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2072 ;;; Some more Emacs-related place types.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2073 (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
2074 ;; 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
2075 (defsetf buffer-modified-p set-buffer-modified-p t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2076 (defsetf buffer-name rename-buffer t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2077 (defsetf buffer-string () (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2078 (list 'progn '(erase-buffer) (list 'insert store)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2079 (defsetf buffer-substring cl-set-buffer-substring)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2080 (defsetf current-buffer set-buffer)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2081 (defsetf current-case-table set-case-table)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2082 (defsetf current-column move-to-column t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2083 (defsetf current-global-map use-global-map t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2084 (defsetf current-input-mode () (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2085 (list 'progn (list 'apply 'set-input-mode store) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2086 (defsetf current-local-map use-local-map t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2087 (defsetf current-window-configuration set-window-configuration t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2088 (defsetf default-file-modes set-default-file-modes t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2089 (defsetf default-value set-default)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2090 (defsetf documentation-property put)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2091 ;;(defsetf extent-data set-extent-data)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2092 (defsetf extent-face set-extent-face)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2093 (defsetf extent-priority set-extent-priority)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2094 ;; XEmacs addition
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2095 (defsetf extent-property (x y &optional ignored-arg) (arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2096 (list 'set-extent-property x y arg))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2097 (defsetf extent-end-position (ext) (store)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2098 `(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
2099 ,store))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2100 (defsetf extent-start-position (ext) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2101 `(progn (set-extent-endpoints ,ext ,store (extent-end-position ,ext))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2102 ,store))
5624
c39052c921b5 New "foreback" face property.
Didier Verna <didier@xemacs.org>
parents: 5619
diff changeset
2103 (defsetf face-foreground (f &optional s) (x) (list 'set-face-foreground f x s))
c39052c921b5 New "foreback" face property.
Didier Verna <didier@xemacs.org>
parents: 5619
diff changeset
2104 (defsetf face-foreback (f &optional s) (x) (list 'set-face-foreback f x s))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2105 (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
2106 (defsetf face-background-pixmap (f &optional s) (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2107 (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
2108 (defsetf face-background-placement (f &optional s) (x)
5502045ec510 The background-placement face property.
Didier Verna <didier@lrde.epita.fr>
parents: 5076
diff changeset
2109 (list 'set-face-background-placement f x s))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2110 (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
2111 (defsetf face-underline-p (f &optional s) (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2112 (list 'set-face-underline-p f x s))
5619
75ad4969a16d Replace the 'flush face property with the opposite 'shrink one.
Didier Verna <didier@xemacs.org>
parents: 5617
diff changeset
2113 (defsetf face-shrink-p (f &optional s) (x)
75ad4969a16d Replace the 'flush face property with the opposite 'shrink one.
Didier Verna <didier@xemacs.org>
parents: 5617
diff changeset
2114 (list 'set-face-shrink-p f x s))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2115 (defsetf file-modes set-file-modes t)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2116 (defsetf frame-height (&optional f) (v)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2117 `(progn (set-frame-height ,f ,v) ,v))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2118 (defsetf frame-parameters modify-frame-parameters t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2119 (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
2120 (defsetf frame-width (&optional f) (v)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2121 `(progn (set-frame-width ,f ,v) ,v))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2122 ;; XEmacs change: frame-properties instead of frame-parameters
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2123 (defsetf frame-properties (&optional f) (p)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2124 `(progn (set-frame-properties ,f ,p) ,p))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2125 (defsetf frame-property (f p &optional ignored-arg) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2126 `(progn (set-frame-property ,f ,v) ,p))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2127 ;; XEmacs addition
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2128 (defsetf current-frame-configuration set-frame-configuration)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2129
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2130 ;; XEmacs: new stuff
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2131 ;; Consoles
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2132 (defsetf selected-console select-console t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2133 (defsetf selected-device select-device t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2134 (defsetf device-baud-rate (&optional d) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2135 `(set-device-baud-rate ,d ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2136 ;; This setf method is a bad idea, because set-specifier *adds* a
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2137 ;; specification, rather than just setting it. The net effect is that
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2138 ;; it makes specifier-instance return VAL, but other things don't work
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2139 ;; as expected -- letf, to name one.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2140 ;(defsetf specifier-instance (spec &optional dom def nof) (val)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2141 ; `(set-specifier ,spec ,val ,dom))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2142
5561
9a93bc90b3bd Add a defsetf for get-char-table, necessary for the tests in the last commit.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5553
diff changeset
2143 (defsetf get-char-table (char table) (store)
9a93bc90b3bd Add a defsetf for get-char-table, necessary for the tests in the last commit.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5553
diff changeset
2144 `(put-char-table ,char ,store ,table))
9a93bc90b3bd Add a defsetf for get-char-table, necessary for the tests in the last commit.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5553
diff changeset
2145
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2146 ;; Annotations
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2147 (defsetf annotation-glyph set-annotation-glyph)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2148 (defsetf annotation-down-glyph set-annotation-down-glyph)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2149 (defsetf annotation-face set-annotation-face)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2150 (defsetf annotation-layout set-annotation-layout)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2151 (defsetf annotation-data set-annotation-data)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2152 (defsetf annotation-action set-annotation-action)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2153 (defsetf annotation-menu set-annotation-menu)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2154 ;; Widget
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2155 (defsetf widget-get widget-put t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2156 (defsetf widget-value widget-value-set t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2157
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2158 ;; Misc
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2159 (defsetf recent-keys-ring-size set-recent-keys-ring-size)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2160 (defsetf symbol-value-in-buffer (s b &optional ignored-arg) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2161 `(with-current-buffer ,b (set ,s ,store)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2162 (defsetf symbol-value-in-console (s c &optional ignored-arg) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2163 `(letf (((selected-console) ,c))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2164 (set ,s ,store)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2165
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2166 (defsetf buffer-dedicated-frame (&optional b) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2167 `(set-buffer-dedicated-frame ,b ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2168 (defsetf console-type-image-conversion-list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2169 set-console-type-image-conversion-list)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2170 (defsetf default-toolbar-position set-default-toolbar-position)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2171 (defsetf device-class (&optional d) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2172 `(set-device-class ,d ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2173 (defsetf extent-begin-glyph set-extent-begin-glyph)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2174 (defsetf extent-begin-glyph-layout set-extent-begin-glyph-layout)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2175 (defsetf extent-end-glyph set-extent-end-glyph)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2176 (defsetf extent-end-glyph-layout set-extent-end-glyph-layout)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2177 (defsetf extent-keymap set-extent-keymap)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2178 (defsetf extent-parent set-extent-parent)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2179 (defsetf extent-properties set-extent-properties)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2180 ;; Avoid adding various face and glyph functions.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2181 (defsetf frame-selected-window (&optional f) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2182 `(set-frame-selected-window ,f ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2183 (defsetf glyph-image (glyph &optional domain) (i)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2184 (list 'set-glyph-image glyph i domain))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2185 (defsetf itimer-function set-itimer-function)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2186 (defsetf itimer-function-arguments set-itimer-function-arguments)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2187 (defsetf itimer-is-idle set-itimer-is-idle)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2188 (defsetf itimer-recorded-run-time set-itimer-recorded-run-time)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2189 (defsetf itimer-restart set-itimer-restart)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2190 (defsetf itimer-uses-arguments set-itimer-uses-arguments)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2191 (defsetf itimer-value set-itimer-value)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2192 (defsetf keymap-parents set-keymap-parents)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2193 (defsetf marker-insertion-type set-marker-insertion-type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2194 (defsetf mouse-pixel-position (&optional d) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2195 `(progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2196 (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
2197 ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2198 (defsetf trunc-stack-length set-trunc-stack-length)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2199 (defsetf trunc-stack-stack set-trunc-stack-stack)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2200 (defsetf undoable-stack-max set-undoable-stack-max)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2201 (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
2202 ;; End of new XEmacs stuff
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2203
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2204 (defsetf getenv setenv t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2205 (defsetf get-register set-register)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2206 (defsetf global-key-binding global-set-key)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2207 (defsetf keymap-parent set-keymap-parent)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2208 ;; XEmacs addition: more keymap-related setf forms
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2209 (defsetf keymap-name set-keymap-name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2210 (defsetf keymap-prompt set-keymap-prompt)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2211 (defsetf keymap-default-binding set-keymap-default-binding)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2212 (defsetf local-key-binding local-set-key)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2213 (defsetf mark set-mark t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2214 (defsetf mark-marker set-mark t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2215 (defsetf marker-position set-marker t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2216 (defsetf match-data store-match-data t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2217 (defsetf mouse-position (scr) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2218 (list 'set-mouse-position scr (list 'car store) (list 'cadr store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2219 (list 'cddr store)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2220 (defsetf overlay-get overlay-put)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2221 (defsetf overlay-start (ov) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2222 (list 'progn (list 'move-overlay ov store (list 'overlay-end ov)) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2223 (defsetf overlay-end (ov) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2224 (list 'progn (list 'move-overlay ov (list 'overlay-start ov) store) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2225 (defsetf point goto-char)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2226 (defsetf point-marker goto-char t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2227 (defsetf point-max () (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2228 (list 'progn (list 'narrow-to-region '(point-min) store) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2229 (defsetf point-min () (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2230 (list 'progn (list 'narrow-to-region store '(point-max)) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2231 (defsetf process-buffer set-process-buffer)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2232 (defsetf process-filter set-process-filter)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2233 (defsetf process-sentinel set-process-sentinel)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2234 ;;(defsetf process-get process-put)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2235 (defsetf read-mouse-position (scr) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2236 (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
2237 ;;(defsetf screen-height set-screen-height t)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2238 ;;(defsetf screen-width set-screen-width t)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2239 (defsetf selected-window select-window)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2240 ;;(defsetf selected-screen select-screen)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2241 (defsetf selected-frame select-frame)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2242 (defsetf standard-case-table set-standard-case-table)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2243 (defsetf syntax-table set-syntax-table)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2244 (defsetf visited-file-modtime set-visited-file-modtime t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2245 (defsetf window-buffer set-window-buffer t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2246 (defsetf window-display-table set-window-display-table t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2247 (defsetf window-dedicated-p set-window-dedicated-p t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2248 (defsetf window-height (&optional window) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2249 `(progn (enlarge-window (- ,store (window-height)) nil ,window) ,store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2250 (defsetf window-hscroll set-window-hscroll)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2251 (defsetf window-point set-window-point)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2252 (defsetf window-start set-window-start)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2253 (defsetf window-width (&optional window) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2254 `(progn (enlarge-window (- ,store (window-width)) t ,window) ,store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2255 (defsetf x-get-cutbuffer x-store-cutbuffer t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2256 (defsetf x-get-cut-buffer x-store-cut-buffer t) ; groan.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2257 (defsetf x-get-secondary-selection x-own-secondary-selection t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2258 (defsetf x-get-selection x-own-selection t)
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
2259 (defsetf get-selection own-selection t)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2260
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2261 ;;; More complex setf-methods.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2262 ;;; These should take &environment arguments, but since full arglists aren't
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2263 ;;; available while compiling cl-macs, we fake it by referring to the global
5562
855b667dea13 Drop cl-macro-environment in favour of byte-compile-macro-environment.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5561
diff changeset
2264 ;;; variable byte-compile-macro-environment directly.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2265
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2266 (define-setf-method apply (func arg1 &rest rest)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2267 (or (and (memq (car-safe func) '(quote function function*))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2268 (symbolp (car-safe (cdr-safe func))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2269 (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
2270 (let* ((form (cons (nth 1 func) (cons arg1 rest)))
5562
855b667dea13 Drop cl-macro-environment in favour of byte-compile-macro-environment.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5561
diff changeset
2271 (method (get-setf-method form byte-compile-macro-environment)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2272 (list (car method) (nth 1 method) (nth 2 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2273 (cl-setf-make-apply (nth 3 method) (cadr func) (car method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2274 (cl-setf-make-apply (nth 4 method) (cadr func) (car method)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2275
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2276 (defun cl-setf-make-apply (form func temps)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2277 (if (eq (car form) 'progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2278 (list* 'progn (cl-setf-make-apply (cadr form) func temps) (cddr form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2279 (or (equal (last form) (last temps))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2280 (error "%s is not suitable for use with setf-of-apply" func))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2281 (list* 'apply (list 'quote (car form)) (cdr form))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2282
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2283 (define-setf-method nthcdr (n place)
5562
855b667dea13 Drop cl-macro-environment in favour of byte-compile-macro-environment.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5561
diff changeset
2284 (let ((method (get-setf-method place byte-compile-macro-environment))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2285 (n-temp (gensym "--nthcdr-n--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2286 (store-temp (gensym "--nthcdr-store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2287 (list (cons n-temp (car method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2288 (cons n (nth 1 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2289 (list store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2290 (list 'let (list (list (car (nth 2 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2291 (list 'cl-set-nthcdr n-temp (nth 4 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2292 store-temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2293 (nth 3 method) store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2294 (list 'nthcdr n-temp (nth 4 method)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2295
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2296 (define-setf-method getf (place tag &optional def)
5562
855b667dea13 Drop cl-macro-environment in favour of byte-compile-macro-environment.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5561
diff changeset
2297 (let ((method (get-setf-method place byte-compile-macro-environment))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2298 (tag-temp (gensym "--getf-tag--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2299 (def-temp (gensym "--getf-def--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2300 (store-temp (gensym "--getf-store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2301 (list (append (car method) (list tag-temp def-temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2302 (append (nth 1 method) (list tag def))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2303 (list store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2304 (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
2305 (list 'plist-put (nth 4 method)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2306 tag-temp store-temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2307 (nth 3 method) store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2308 (list 'getf (nth 4 method) tag-temp def-temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2309
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2310 (define-setf-method substring (place from &optional to)
5562
855b667dea13 Drop cl-macro-environment in favour of byte-compile-macro-environment.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5561
diff changeset
2311 (let ((method (get-setf-method place byte-compile-macro-environment))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2312 (from-temp (gensym "--substring-from--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2313 (to-temp (gensym "--substring-to--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2314 (store-temp (gensym "--substring-store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2315 (list (append (car method) (list from-temp to-temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2316 (append (nth 1 method) (list from to))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2317 (list store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2318 (list 'let (list (list (car (nth 2 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2319 (list 'cl-set-substring (nth 4 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2320 from-temp to-temp store-temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2321 (nth 3 method) store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2322 (list 'substring (nth 4 method) from-temp to-temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2323
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2324 ;; XEmacs addition
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2325 (define-setf-method values (&rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2326 (let ((methods (mapcar #'(lambda (x)
5562
855b667dea13 Drop cl-macro-environment in favour of byte-compile-macro-environment.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5561
diff changeset
2327 (get-setf-method x byte-compile-macro-environment))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2328 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2329 (store-temp (gensym "--values-store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2330 (list (apply 'append (mapcar 'first methods))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2331 (apply 'append (mapcar 'second methods))
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2332 `((,store-temp
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2333 (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
2334 (cons 'values
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2335 (mapcar #'(lambda (m)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2336 (cl-setf-do-store (cons (car (third m)) (fourth m))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2337 (list 'pop store-temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2338 methods))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2339 (cons 'list (mapcar 'fifth methods)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2340
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2341 ;;; Getting and optimizing setf-methods.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2342 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2343 (defun get-setf-method (place &optional env)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2344 "Return a list of five values describing the setf-method for PLACE.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2345 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
2346 a macro like `setf' or `incf'."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2347 (if (symbolp place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2348 (let ((temp (gensym "--setf--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2349 (list nil nil (list temp) (list 'setq place temp) place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2350 (or (and (symbolp (car place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2351 (let* ((func (car place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2352 (name (symbol-name func))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2353 (method (get func 'setf-method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2354 (case-fold-search nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2355 (or (and method
5562
855b667dea13 Drop cl-macro-environment in favour of byte-compile-macro-environment.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5561
diff changeset
2356 (let ((byte-compile-macro-environment env))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2357 (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
2358 (if (and (consp method) (eql (length method) 5))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2359 method
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2360 (error "Setf-method for %s returns malformed method"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2361 func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2362 (and (save-match-data
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2363 (string-match "\\`c[ad][ad][ad]?[ad]?r\\'" name))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2364 (get-setf-method (compiler-macroexpand place)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2365 (and (eq func 'edebug-after)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2366 (get-setf-method (nth (1- (length place)) place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2367 env)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2368 (if (eq place (setq place (macroexpand place env)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2369 (if (and (symbolp (car place)) (fboundp (car place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2370 (symbolp (symbol-function (car place))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2371 (get-setf-method (cons (symbol-function (car place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2372 (cdr place)) env)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2373 (error "No setf-method known for %s" (car place)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2374 (get-setf-method place env)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2375
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2376 (defun cl-setf-do-modify (place opt-expr)
5562
855b667dea13 Drop cl-macro-environment in favour of byte-compile-macro-environment.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5561
diff changeset
2377 (let* ((method (get-setf-method place byte-compile-macro-environment))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2378 (temps (car method)) (values (nth 1 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2379 (lets nil) (subs nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2380 (optimize (and (not (eq opt-expr 'no-opt))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2381 (or (and (not (eq opt-expr 'unsafe))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2382 (cl-safe-expr-p opt-expr))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2383 (cl-setf-simple-store-p (car (nth 2 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2384 (nth 3 method)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2385 (simple (and optimize (consp place) (cl-simple-exprs-p (cdr place)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2386 (while values
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2387 (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
2388 (push (cons (pop temps) (pop values)) subs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2389 (push (list (pop temps) (pop values)) lets)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2390 (list (nreverse lets)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2391 (cons (car (nth 2 method)) (sublis subs (nth 3 method)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2392 (sublis subs (nth 4 method)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2393
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2394 (defun cl-setf-do-store (spec val)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2395 (let ((sym (car spec))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2396 (form (cdr spec)))
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2397 (if (consp sym)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2398 ;; 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
2399 (let* ((orig (copy-list sym))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2400 (intermediate (last orig))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2401 (circular-limit 32))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2402 (while (consp (car intermediate))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2403 (when (zerop circular-limit)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2404 (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
2405 (setq intermediate (last (car intermediate))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2406 circular-limit (1- circular-limit)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2407 (setcdr intermediate (list val))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2408 `(let (,orig)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2409 ,form))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2410 (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
2411 (and (cl-simple-expr-p val)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2412 (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
2413 (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
2414 (subst val sym form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2415 (list 'let (list (list sym val)) form)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2416
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2417 (defun cl-setf-simple-store-p (sym form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2418 (and (consp form) (eq (cl-expr-contains form sym) 1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2419 (eq (nth (1- (length form)) form) sym)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2420 (symbolp (car form)) (fboundp (car form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2421 (not (eq (car-safe (symbol-function (car form))) 'macro))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2422
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2423 ;;; The standard modify macros.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2424 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2425 (defmacro setf (&rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2426 "(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
2427 This is a generalized version of `setq'; the PLACEs may be symbolic
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2428 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
2429 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
2430 The return value is the last VAL in the list."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2431 (if (cdr (cdr args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2432 (let ((sets nil))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2433 (while args (push (list 'setf (pop args) (pop args)) sets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2434 (cons 'progn (nreverse sets)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2435 (if (symbolp (car args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2436 (and args (cons 'setq args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2437 (let* ((method (cl-setf-do-modify (car args) (nth 1 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2438 (store (cl-setf-do-store (nth 1 method) (nth 1 args))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2439 (if (car method) (list 'let* (car method) store) store)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2440
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2441 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2442 (defmacro psetf (&rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2443 "(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
2444 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
2445 before assigning any PLACEs to the corresponding values."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2446 (let ((p args) (simple t) (vars nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2447 (while p
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2448 (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
2449 (setq simple nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2450 (if (memq (car p) vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2451 (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
2452 (push (pop p) vars)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2453 (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
2454 (pop p))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2455 (if simple
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2456 (list 'progn (cons 'setf args) nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2457 (setq args (reverse args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2458 (let ((expr (list 'setf (cadr args) (car args))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2459 (while (setq args (cddr args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2460 (setq expr (list 'setf (cadr args) (list 'prog1 (car args) expr))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2461 (list 'progn expr nil)))))
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 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2464 (defun cl-do-pop (place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2465 (if (cl-simple-expr-p place)
5651
ae2fdb1fd9e0 Improve for-effect handling in a few places, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents: 5632
diff changeset
2466 (list 'prog1 (list 'car-safe place) (list 'setf place (list 'cdr place)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2467 (let* ((method (cl-setf-do-modify place t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2468 (temp (gensym "--pop--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2469 (list 'let*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2470 (append (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2471 (list (list temp (nth 2 method))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2472 (list 'prog1
5651
ae2fdb1fd9e0 Improve for-effect handling in a few places, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents: 5632
diff changeset
2473 (list 'car-safe temp)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2474 (cl-setf-do-store (nth 1 method) (list 'cdr temp)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2475
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2476 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2477 (defmacro remf (place tag)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
2478 "Remove TAG from property list PLACE.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2479 PLACE may be a symbol, or any generalized variable allowed by `setf'.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2480 The form returns true if TAG was found and removed, nil otherwise."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2481 (let* ((method (cl-setf-do-modify place t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2482 (tag-temp (and (not (cl-const-expr-p tag)) (gensym "--remf-tag--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2483 (val-temp (and (not (cl-simple-expr-p place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2484 (gensym "--remf-place--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2485 (ttag (or tag-temp tag))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2486 (tval (or val-temp (nth 2 method))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2487 (list 'let*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2488 (append (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2489 (and val-temp (list (list val-temp (nth 2 method))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2490 (and tag-temp (list (list tag-temp tag))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2491 (list 'if (list 'eq ttag (list 'car tval))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2492 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2493 (cl-setf-do-store (nth 1 method) (list 'cddr tval))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2494 t)
5285
99de5fd48e87 Tighten up Common Lisp compatibility, #'butlast, #'nbutlast, #'tailp, #'ldiff
Aidan Kehoe <kehoea@parhasard.net>
parents: 5269
diff changeset
2495 (list 'plist-remprop tval ttag)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2496
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2497 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2498 (defmacro shiftf (place &rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2499 "(shiftf PLACE PLACE... VAL): shift left among PLACEs.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2500 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
2501 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
2502 ;; 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
2503 (if (every #'symbolp (butlast (cons place args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2504 (list* 'prog1 place
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2505 (let ((sets nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2506 (while args
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2507 (push (list 'setq place (car args)) sets)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2508 (setq place (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2509 (nreverse sets)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2510 (let* ((places (reverse (cons place args)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2511 (form (pop places)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2512 (while places
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2513 (let ((method (cl-setf-do-modify (pop places) 'unsafe)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2514 (setq form (list 'let* (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2515 (list 'prog1 (nth 2 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2516 (cl-setf-do-store (nth 1 method) form))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2517 form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2518
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2519 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2520 (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
2521 "Rotate left among PLACES.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2522 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
2523 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
2524 (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
2525 (and (cdr places)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2526 (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
2527 (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
2528 (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
2529 (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
2530 (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
2531 (let* ((places (reverse places))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2532 (temp (gensym "--rotatef--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2533 (form temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2534 (while (cdr places)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2535 (let ((method (cl-setf-do-modify (pop places) 'unsafe)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2536 (setq form (list 'let* (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2537 (list 'prog1 (nth 2 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2538 (cl-setf-do-store (nth 1 method) form))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2539 (let ((method (cl-setf-do-modify (car places) 'unsafe)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2540 (list 'let* (append (car method) (list (list temp (nth 2 method))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2541 (cl-setf-do-store (nth 1 method) form) nil)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2542
4742
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2543 ;; 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
2544 ;; 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
2545 ;; 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
2546 ;; 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
2547 ;; 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
2548 ;; 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
2549 ;; 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
2550 ;; wrong behaviour for gethash:
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2551 ;;
4820
e6dec75ded0e Use keywords, not ordinary symbols, in the structure syntax for hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4810
diff changeset
2552 ;; (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
2553 ;; print-gensym t)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2554 ;; => t
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2555 ;; (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
2556 ;; => #:G68010
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2557 ;; (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
2558 ;; (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
2559 ;; => "key value is 4000"
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2560 ;; (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
2561 ;; => 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
2562 ;;
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2563 ;; 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
2564
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2565 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2566 (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
2567 "Temporarily bind to PLACEs.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2568 This is the analogue of `let', but with generalized variables (in the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2569 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
2570 VALUE, then the BODY forms are executed. On exit, either normally or
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2571 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
2572 values. Note that this macro is *not* available in Common Lisp.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2573 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
2574 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
2575
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2576 arguments: (((PLACE VALUE) &rest BINDINGS) &body BODY)"
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2577 (if (and (not (cdr bindings)) (cdar bindings) (symbolp (caar bindings)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2578 (list* 'let bindings body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2579 (let ((lets nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2580 (rev (reverse bindings)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2581 (while rev
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2582 (let* ((place (if (symbolp (caar rev))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2583 (list 'symbol-value (list 'quote (caar rev)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2584 (caar rev)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2585 (value (cadar rev))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2586 (method (cl-setf-do-modify place 'no-opt))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2587 (save (gensym "--letf-save--"))
4742
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2588 (bound (and (memq (car place)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2589 '(symbol-value symbol-function values))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2590 (gensym "--letf-bound--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2591 (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
2592 (gensym "--letf-val--")))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2593 (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
2594 (gensym "--letf-syms--")))
4783
e29fcfd8df5f Eliminate most core code byte-compile warnings.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4742
diff changeset
2595 (cursor (and syms (gensym "--letf-cursor--"))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2596 (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
2597 (cond
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2598 (syms
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2599 `((,syms ',(loop
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2600 for sym in (cdr place)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2601 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
2602 (,cursor ,syms)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2603 (,bound nil)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2604 (,save
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2605 (prog2
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2606 (while (consp ,cursor)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2607 (setq ,bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2608 (cons (and (boundp (car ,cursor))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2609 (symbol-value
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2610 (car ,cursor)))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2611 ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2612 ,cursor (cdr ,cursor)))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2613 ;; 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
2614 ;; variable here, to initialise ,save:
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2615 (nreverse ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2616 ;; Now, really initialise ,bound:
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2617 (setq ,cursor ,syms
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2618 ,bound nil
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2619 ,bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2620 (progn (while (consp ,cursor)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2621 (setq ,bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2622 (cons
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2623 (boundp (car ,cursor))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2624 ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2625 ,cursor (cdr ,cursor)))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2626 (nreverse ,bound)))))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2627 (bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2628 (list (list bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2629 (list (if (eq (car place)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2630 'symbol-value)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2631 'boundp 'fboundp)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2632 (nth 1 (nth 2 method))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2633 (list save (list 'and bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2634 (nth 2 method)))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2635 (t
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2636 (list (list save (nth 2 method)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2637 (and temp (list (list temp value)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2638 lets)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2639 body (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2640 (list 'unwind-protect
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2641 (cons 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2642 (if (cdr (car rev))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2643 (cons (cl-setf-do-store (nth 1 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2644 (or temp value))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2645 body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2646 body))
4742
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2647 (cond
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2648 (syms
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2649 `(while (consp ,syms)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2650 (if (car ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2651 (set (car ,syms) (car ,save))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2652 (makunbound (car ,syms)))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2653 (setq ,syms (cdr ,syms)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2654 ,bound (cdr ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2655 ,save (cdr ,save))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2656 (bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2657 (list 'if bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2658 (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
2659 (list (if (eq (car place)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2660 'symbol-function)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2661 'fmakunbound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2662 'makunbound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2663 (nth 1 (nth 2 method)))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2664 (t
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2665 (cl-setf-do-store (nth 1 method) save)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2666 rev (cdr rev))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2667 (list* 'let* lets body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2668
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2669 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2670 (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
2671 "Temporarily bind to PLACES.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2672 This is the analogue of `let*', but with generalized variables (in the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2673 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
2674 VALUE, then the BODY forms are executed. On exit, either normally or
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2675 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
2676 values. Note that this macro is *not* available in Common Lisp.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2677 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
2678 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
2679
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2680 arguments: (((PLACE VALUE) &rest BINDINGS) &body BODY)"
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2681 (if (null bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2682 (cons 'progn body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2683 (setq bindings (reverse bindings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2684 (while bindings
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2685 (setq body (list (list* 'letf (list (pop bindings)) body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2686 (car body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2687
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2688 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2689 (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
2690 "Set PLACE to (FUNC PLACE ARGS...).
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2691 FUNC should be an unquoted function name. PLACE may be a symbol,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2692 or any generalized variable allowed by `setf'."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2693 (let* ((method (cl-setf-do-modify place (cons 'list args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2694 (rargs (cons (nth 2 method) args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2695 (list 'let* (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2696 (cl-setf-do-store (nth 1 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2697 (if (symbolp func) (cons func rargs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2698 (list* 'funcall (list 'function func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2699 rargs))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2700
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2701 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2702 (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
2703 "Set PLACE to (FUNC ARG1 PLACE ARGS...).
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2704 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
2705 (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
2706 (list 'setf place (list* func arg1 place args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2707 (let* ((method (cl-setf-do-modify place (cons 'list args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2708 (temp (and (not (cl-const-expr-p arg1)) (gensym "--arg1--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2709 (rargs (list* (or temp arg1) (nth 2 method) args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2710 (list 'let* (append (and temp (list (list temp arg1))) (car method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2711 (cl-setf-do-store (nth 1 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2712 (if (symbolp func) (cons func rargs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2713 (list* 'funcall (list 'function func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2714 rargs)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2715
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2716 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2717 (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
2718 "Define a `setf'-like modify macro.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2719 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
2720 from ARGLIST using FUNC: (define-modify-macro incf (&optional (n 1)) +)"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2721 (if (memq '&key arglist) (error "&key not allowed in define-modify-macro"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2722 (let ((place (gensym "--place--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2723 (list 'defmacro* name (cons place arglist) doc
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2724 (list* (if (memq '&rest arglist) 'list* 'list)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2725 '(quote callf) (list 'quote func) place
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2726 (cl-arglist-args arglist)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2727
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2728
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2729 ;;; Structures.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2730
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2731 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2732 (defmacro defstruct (struct &rest descs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2733 "(defstruct (NAME OPTIONS...) (SLOT SLOT-OPTS...)...): define a struct type.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2734 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
2735 stored in SLOTs. This defines a `make-NAME' constructor, a `copy-NAME'
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2736 copier, a `NAME-p' predicate, and setf-able `NAME-SLOT' accessors."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2737 (let* ((name (if (consp struct) (car struct) struct))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2738 (opts (cdr-safe struct))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2739 (slots nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2740 (defaults nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2741 (conc-name (concat (symbol-name name) "-"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2742 (constructor (intern (format "make-%s" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2743 (constrs nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2744 (copier (intern (format "copy-%s" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2745 (predicate (intern (format "%s-p" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2746 (print-func nil) (print-auto nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2747 (safety (if (cl-compiling-file) cl-optimize-safety 3))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2748 (include nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2749 (tag (intern (format "cl-struct-%s" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2750 (tag-symbol (intern (format "cl-struct-%s-tags" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2751 (include-descs nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2752 (side-eff nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2753 (type nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2754 (named nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2755 (forms nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2756 pred-form pred-check)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2757 (if (stringp (car descs))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2758 (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
2759 (pop descs)) forms))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2760 (setq descs (cons '(cl-tag-slot)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2761 (mapcar #'(lambda (x) (if (consp x) x (list x)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2762 descs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2763 (while opts
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2764 (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
2765 (args (cdr-safe (pop opts))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2766 (cond ((eq opt :conc-name)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2767 (if args
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2768 (setq conc-name (if (car args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2769 (symbol-name (car args)) ""))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2770 ((eq opt :constructor)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2771 (if (cdr args)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2772 (push args constrs)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2773 (if args (setq constructor (car args)))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2774 ((eq opt :copier)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2775 (if args (setq copier (car args))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2776 ((eq opt :predicate)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2777 (if args (setq predicate (car args))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2778 ((eq opt :include)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2779 (setq include (car args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2780 include-descs (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2781 (if (consp x) x (list x)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2782 (cdr args))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2783 ((eq opt :print-function)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2784 (setq print-func (car args)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2785 ((eq opt :type)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2786 (setq type (car args)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2787 ((eq opt :named)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2788 (setq named t))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2789 ((eq opt :initial-offset)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2790 (setq descs (nconc (make-list (car args) '(cl-skip-slot))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2791 descs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2792 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2793 (error "Slot option %s unrecognized" opt)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2794 (if print-func
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2795 (setq print-func (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2796 (list 'funcall (list 'function print-func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2797 'cl-x 'cl-s 'cl-n) t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2798 (or type (and include (not (get include 'cl-struct-print)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2799 (setq print-auto t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2800 print-func (and (or (not (or include type)) (null print-func))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2801 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2802 (list 'princ (format "#S(%s" name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2803 'cl-s))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2804 (if include
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2805 (let ((inc-type (get include 'cl-struct-type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2806 (old-descs (get include 'cl-struct-slots)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2807 (or inc-type (error "%s is not a struct name" include))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2808 (and type (not (eq (car inc-type) type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2809 (error ":type disagrees with :include for %s" name))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2810 (while include-descs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2811 (setcar (memq (or (assq (caar include-descs) old-descs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2812 (error "No slot %s in included struct %s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2813 (caar include-descs) include))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2814 old-descs)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2815 (pop include-descs)))
5652
cc6f0266bc36 Avoid #'delq in core Lisp, for the sake of style, a very slightly smaller binary
Aidan Kehoe <kehoea@parhasard.net>
parents: 5651
diff changeset
2816 (setq descs (append old-descs (delete* (assq 'cl-tag-slot descs) descs))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2817 type (car inc-type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2818 named (assq 'cl-tag-slot descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2819 (if (cadr inc-type) (setq tag name named t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2820 (let ((incl include))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2821 (while incl
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2822 (push (list 'pushnew (list 'quote tag)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2823 (intern (format "cl-struct-%s-tags" incl)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2824 forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2825 (setq incl (get incl 'cl-struct-include)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2826 (if type
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2827 (progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2828 (or (memq type '(vector list))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2829 (error "Illegal :type specifier: %s" type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2830 (if named (setq tag name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2831 (setq type 'vector named 'true)))
5652
cc6f0266bc36 Avoid #'delq in core Lisp, for the sake of style, a very slightly smaller binary
Aidan Kehoe <kehoea@parhasard.net>
parents: 5651
diff changeset
2832 (or named (setq descs (delete* (assq 'cl-tag-slot descs) descs)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2833 (push (list 'defvar tag-symbol) forms)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2834 (setq pred-form (and named
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2835 (let ((pos (- (length descs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2836 (length (memq (assq 'cl-tag-slot descs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2837 descs)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2838 (if (eq type 'vector)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2839 (list 'and '(vectorp cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2840 (list '>= '(length cl-x) (length descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2841 (list 'memq (list 'aref 'cl-x pos)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2842 tag-symbol))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2843 (if (= pos 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2844 (list 'memq '(car-safe cl-x) tag-symbol)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2845 (list 'and '(consp cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2846 (list 'memq (list 'nth pos 'cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2847 tag-symbol))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2848 pred-check (and pred-form (> safety 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2849 (if (and (eq (caadr pred-form) 'vectorp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2850 (= safety 1))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2851 (cons 'and (cdddr pred-form)) pred-form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2852 (let ((pos 0) (descp descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2853 (while descp
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2854 (let* ((desc (pop descp))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2855 (slot (car desc)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2856 (if (memq slot '(cl-tag-slot cl-skip-slot))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2857 (progn
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2858 (push nil slots)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2859 (push (and (eq slot 'cl-tag-slot) (list 'quote tag))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2860 defaults))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2861 (if (assq slot descp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2862 (error "Duplicate slots named %s in %s" slot name))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2863 (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
2864 (push slot slots)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2865 (push (nth 1 desc) defaults)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2866 (push (list*
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2867 'defsubst* accessor '(cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2868 (append
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2869 (and pred-check
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2870 (list (list 'or pred-check
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2871 (list 'error
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2872 (format "%s accessing a non-%s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2873 accessor name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2874 'cl-x))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2875 (list (if (eq type 'vector) (list 'aref 'cl-x pos)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2876 (if (= pos 0) '(car cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2877 (list 'nth pos 'cl-x)))))) forms)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2878 (push (cons accessor t) side-eff)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2879 (push (list 'define-setf-method accessor '(cl-x)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2880 (if (cadr (memq :read-only (cddr desc)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2881 (list 'error (format "%s is a read-only slot"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2882 accessor))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2883 (list 'cl-struct-setf-expander 'cl-x
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2884 (list 'quote name) (list 'quote accessor)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2885 (and pred-check (list 'quote pred-check))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2886 pos)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2887 forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2888 (if print-auto
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2889 (nconc print-func
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2890 (list (list 'princ (format " %s" slot) 'cl-s)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2891 (list 'prin1 (list accessor 'cl-x) 'cl-s)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2892 (setq pos (1+ pos))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2893 (setq slots (nreverse slots)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2894 defaults (nreverse defaults))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2895 (and predicate pred-form
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2896 (progn (push (list 'defsubst* predicate '(cl-x)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2897 (if (eq (car pred-form) 'and)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2898 (append pred-form '(t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2899 (list 'and pred-form t))) forms)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2900 (push (cons predicate 'error-free) side-eff)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2901 (and copier
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2902 (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
2903 (push (cons copier t) side-eff)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2904 (if constructor
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2905 (push (list constructor
5652
cc6f0266bc36 Avoid #'delq in core Lisp, for the sake of style, a very slightly smaller binary
Aidan Kehoe <kehoea@parhasard.net>
parents: 5651
diff changeset
2906 (cons '&key (remove* nil slots)))
cc6f0266bc36 Avoid #'delq in core Lisp, for the sake of style, a very slightly smaller binary
Aidan Kehoe <kehoea@parhasard.net>
parents: 5651
diff changeset
2907 constrs))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2908 (while constrs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2909 (let* ((name (caar constrs))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2910 (args (cadr (pop constrs)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2911 (anames (cl-arglist-args args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2912 (make (mapcar* #'(lambda (s d) (if (memq s anames) s d))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2913 slots defaults)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2914 (push (list 'defsubst* name
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2915 (list* '&cl-defs (list 'quote (cons nil descs)) args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2916 (cons type make)) forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2917 (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
2918 (push (cons name t) side-eff))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2919 (if print-auto (nconc print-func (list '(princ ")" cl-s) t)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2920 (if print-func
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2921 (push (list 'push
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2922 (list 'function
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2923 (list 'lambda '(cl-x cl-s cl-n)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2924 (list 'and pred-form print-func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2925 'custom-print-functions) forms))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2926 (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
2927 (push (list* 'eval-when '(compile load eval)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2928 (list 'put (list 'quote name) '(quote cl-struct-slots)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2929 (list 'quote descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2930 (list 'put (list 'quote name) '(quote cl-struct-type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2931 (list 'quote (list type (eq named t))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2932 (list 'put (list 'quote name) '(quote cl-struct-include)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2933 (list 'quote include))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2934 (list 'put (list 'quote name) '(quote cl-struct-print)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2935 print-auto)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2936 (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2937 (list 'put (list 'quote (car x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2938 '(quote side-effect-free)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2939 (list 'quote (cdr x))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2940 side-eff))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2941 forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2942 (cons 'progn (nreverse (cons (list 'quote name) forms)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2943
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2944 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2945 (defun cl-struct-setf-expander (x name accessor pred-form pos)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2946 (let* ((temp (gensym "--x--")) (store (gensym "--store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2947 (list (list temp) (list x) (list store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2948 (append '(progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2949 (and pred-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2950 (list (list 'or (subst temp 'cl-x pred-form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2951 (list 'error
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2952 (format
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2953 "%s storing a non-%s" accessor name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2954 temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2955 (list (if (eq (car (get name 'cl-struct-type)) 'vector)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2956 (list 'aset temp pos store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2957 (list 'setcar
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2958 (if (<= pos 5)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2959 (let ((xx temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2960 (while (>= (setq pos (1- pos)) 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2961 (setq xx (list 'cdr xx)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2962 xx)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2963 (list 'nthcdr pos temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2964 store))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2965 (list accessor temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2966
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2967
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2968 ;;; Types and assertions.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2969
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2970 ;;;###autoload
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2971 (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
2972 "Define NAME as a new data type.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2973 The type name can then be used in `typecase', `check-type', etc."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2974 (list 'eval-when '(compile load eval)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2975 (cl-transform-function-property
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2976 name 'cl-deftype-handler (cons (list* '&cl-defs ''('*) arglist) body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2977
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2978 (defun cl-make-type-test (val type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2979 (if (symbolp type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2980 (cond ((get type 'cl-deftype-handler)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2981 (cl-make-type-test val (funcall (get type 'cl-deftype-handler))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2982 ((memq type '(nil t)) type)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2983 ((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
2984 ((eq type 'float) `(floatp ,val))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2985 ((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
2986 ((eq type 'fixnum) `(fixnump ,val))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2987 ;; 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
2988 ((memq type '(character string-char)) `(characterp ,val))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2989 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2990 (let* ((name (symbol-name type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2991 (namep (intern (concat name "p"))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2992 (if (fboundp namep) (list namep val)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2993 (list (intern (concat name "-p")) val)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2994 (cond ((get (car type) 'cl-deftype-handler)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2995 (cl-make-type-test val (apply (get (car type) 'cl-deftype-handler)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2996 (cdr type))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2997 ((memq (car-safe type) '(integer float real number))
5652
cc6f0266bc36 Avoid #'delq in core Lisp, for the sake of style, a very slightly smaller binary
Aidan Kehoe <kehoea@parhasard.net>
parents: 5651
diff changeset
2998 (delete* t (list 'and (cl-make-type-test val (car type))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2999 (if (memq (cadr type) '(* nil)) t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3000 (if (consp (cadr type)) (list '> val (caadr type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3001 (list '>= val (cadr type))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3002 (if (memq (caddr type) '(* nil)) t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3003 (if (consp (caddr type)) (list '< val (caaddr type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3004 (list '<= val (caddr type)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3005 ((memq (car-safe type) '(and or not))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3006 (cons (car type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3007 (mapcar #'(lambda (x) (cl-make-type-test val x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3008 (cdr type))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3009 ((memq (car-safe type) '(member member*))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3010 (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
3011 ((eq (car-safe type) 'eql)
09fed7053634 Handle slightly more complex type specifications, #'coerce, #'typep.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5301
diff changeset
3012 (list 'eql (cadr type) val))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3013 ((eq (car-safe type) 'satisfies) (list (cadr type) val))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3014 (t (error "Bad type spec: %s" type)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3015
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3016 ;;;###autoload
444
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 442
diff changeset
3017 (defun typep (object type) ; See compiler macro below.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3018 "Check that OBJECT is of type TYPE.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3019 TYPE is a Common Lisp-style type specifier."
444
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 442
diff changeset
3020 (eval (cl-make-type-test 'object type)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3021
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3022 ;;;###autoload
446
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
3023 (defmacro check-type (place type &optional string)
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
3024 "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
3025 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
3026 (and (or (not (cl-compiling-file))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3027 (< cl-optimize-speed 3) (= cl-optimize-safety 3))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3028 (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
3029 (test (cl-make-type-test temp type))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3030 (signal-error `(signal 'wrong-type-argument
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3031 ,(list 'list (or string (list 'quote type))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3032 temp (list 'quote place))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3033 (body
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3034 (condition-case nil
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3035 `(while (not ,test)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3036 ,(macroexpand `(setf ,place ,signal-error)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3037 (error
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3038 `(if ,test (progn ,signal-error nil))))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3039 (if (eq temp place) `(progn ,body nil)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3040 `(let ((,temp ,place)) ,body nil)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3041
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3042 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3043 (defmacro assert (form &optional show-args string &rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3044 "Verify that FORM returns non-nil; signal an error if not.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3045 Second arg SHOW-ARGS means to include arguments of FORM in message.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3046 Other args STRING and ARGS... are arguments to be passed to `error'.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3047 They are not evaluated unless the assertion fails. If STRING is
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3048 omitted, a default message listing FORM itself is used."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3049 (and (or (not (cl-compiling-file))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3050 (< cl-optimize-speed 3) (= cl-optimize-safety 3))
5614
281bf2b87915 Call #'cl-macroexpand-all in #'cl-transform-function-property
Aidan Kehoe <kehoea@parhasard.net>
parents: 5609
diff changeset
3051 (let ((sargs (and show-args
281bf2b87915 Call #'cl-macroexpand-all in #'cl-transform-function-property
Aidan Kehoe <kehoea@parhasard.net>
parents: 5609
diff changeset
3052 ;; #'remove-if isn't necessarily available yet.
281bf2b87915 Call #'cl-macroexpand-all in #'cl-transform-function-property
Aidan Kehoe <kehoea@parhasard.net>
parents: 5609
diff changeset
3053 (remove* t (cdr form) :key #'cl-const-expr-p))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3054 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3055 (list 'or form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3056 (if string
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3057 (list* 'error string (append sargs args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3058 (list 'signal '(quote cl-assertion-failed)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3059 (list* 'list (list 'quote form) sargs))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3060 nil))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3061
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3062 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3063 (defmacro ignore-errors (&rest body)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3064 "Execute BODY; if an error occurs, return nil.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3065 Otherwise, return result of last form in BODY."
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3066 `(condition-case nil (progn ,@body) (error nil)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3067
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3068 ;; XEmacs addition
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3069 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3070 (defmacro ignore-file-errors (&rest body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3071 "Execute FORMS; if an error of type `file-error' occurs, return nil.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3072 Otherwise, return result of last FORM."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3073 `(condition-case nil (progn ,@body) (file-error nil)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3074
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3075
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3076 ;;; Compiler macros.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3077
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3078 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3079 (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
3080 "Define a compiler-only macro.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3081 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
3082 FUNC is compiled (i.e., not interpreted). Compiler macros should be used
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3083 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
3084 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
3085 FUNC, though possibly more efficiently. Note that, like regular macros,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3086 compiler macros are expanded repeatedly until no further expansions are
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3087 possible. Unlike regular macros, BODY can decide to \"punt\" and leave the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3088 original function call alone by declaring an initial `&whole foo' parameter
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3089 and then returning foo."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3090 (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
3091 (while (consp p) (push (pop p) res))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3092 (setq args (nconc (nreverse res) (and p (list '&rest p)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3093 (list 'eval-when '(compile load eval)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3094 (cl-transform-function-property
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3095 func 'cl-compiler-macro
5652
cc6f0266bc36 Avoid #'delq in core Lisp, for the sake of style, a very slightly smaller binary
Aidan Kehoe <kehoea@parhasard.net>
parents: 5651
diff changeset
3096 (cons (if (memq '&whole args) (delete* '&whole args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3097 (cons '--cl-whole-arg-- args)) body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3098 (list 'or (list 'get (list 'quote func) '(quote byte-compile))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3099 (list 'put (list 'quote func) '(quote byte-compile)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3100 '(quote cl-byte-compile-compiler-macro)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3101
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3102 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3103 (defun compiler-macroexpand (form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3104 (while
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3105 (let ((func (car-safe form)) (handler nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3106 (while (and (symbolp func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3107 (not (setq handler (get func 'cl-compiler-macro)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3108 (fboundp func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3109 (or (not (eq (car-safe (symbol-function func)) 'autoload))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3110 (load (nth 1 (symbol-function func)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3111 (setq func (symbol-function func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3112 (and handler
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3113 (not (eq form (setq form (apply handler form (cdr form))))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3114 form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3115
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3116 (defun cl-byte-compile-compiler-macro (form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3117 (if (eq form (setq form (compiler-macroexpand form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3118 (byte-compile-normal-call form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3119 (byte-compile-form form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3120
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3121 (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
3122 "Define NAME as a function.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3123 Like `defun', except the function is automatically declared `inline',
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3124 ARGLIST allows full Common Lisp conventions, and BODY is implicitly
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3125 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
3126 (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
3127 (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
3128 body
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3129 (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
3130 (pbody (cons 'progn exec-body))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3131 (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
3132 (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
3133 (list 'progn
5523
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3134 (if (or p (memq '&rest arglist))
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3135 ; Defaults refer to earlier args, or we would have to cons up
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3136 ; something for &rest:
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3137 (list 'proclaim-inline name)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3138 (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
3139 (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
3140 (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
3141 (cons '&cl-quote arglist))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3142 (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
3143 (list 'quote (list* 'block name exec-body))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3144 (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
3145 (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
3146 (list* 'defun* name arglist docstring body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3147
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3148 (defun cl-defsubst-expand (argns body simple whole unsafe &rest argvs)
5523
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3149 (if (and whole (not (cl-safe-expr-p (cons 'progn argvs))))
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3150 whole
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3151 (if (cl-simple-exprs-p argvs)
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3152 (setq simple t))
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3153 (let* ((symbol-macros nil)
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3154 (lets (mapcan #'(lambda (argn argv)
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3155 (if (or simple (cl-const-expr-p argv))
5569
d19b6e3bdf91 #'cl-defsubst-expand; avoid mutually-recursive symbol macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5567
diff changeset
3156 (progn
d19b6e3bdf91 #'cl-defsubst-expand; avoid mutually-recursive symbol macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5567
diff changeset
3157 ;; Avoid infinite loop on symbol macro
5570
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3158 ;; expansion:
5569
d19b6e3bdf91 #'cl-defsubst-expand; avoid mutually-recursive symbol macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5567
diff changeset
3159 (or (block find
5570
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3160 (subst nil argn argvs :test
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3161 #'(lambda (elt tree)
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3162 ;; Give nil if argn is
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3163 ;; in argvs somewhere:
5569
d19b6e3bdf91 #'cl-defsubst-expand; avoid mutually-recursive symbol macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5567
diff changeset
3164 (if (eq elt tree)
5570
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3165 (return-from find)))))
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3166 (let ((copy-symbol (copy-symbol argn)))
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3167 ;; Rename ARGN within BODY so it
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3168 ;; doesn't conflict with its value
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3169 ;; in the including scope:
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3170 (setq body
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3171 (cl-macroexpand-all
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3172 body `((,(eq-hash argn)
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3173 ,copy-symbol)))
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3174 argn copy-symbol)))
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3175 (push (list argn argv) symbol-macros)
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3176 (and unsafe (list (list argn argv))))
5523
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3177 (list (list argn argv))))
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3178 argns argvs)))
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3179 `(let ,lets
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3180 (symbol-macrolet
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3181 ;; #### Bug; this will happily substitute in places where the
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3182 ;; symbol is being shadowed in a different scope (e.g. inside
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3183 ;; let bindings or lambda expressions where it has been
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3184 ;; bound). We don't have GNU's issue where the replacement will
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3185 ;; be done when the symbol is used in a function context,
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3186 ;; because we're using #'symbol-macrolet instead of #'subst.
5570
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3187 ;;
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3188 ;; #'symbol-macrolet as specified by Common Lisp is shadowed by
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3189 ;; #'let, #'let* and lambda argument lists, and that would suit
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3190 ;; our purposes here perfectly; we could implement it in
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3191 ;; cl-macroexpand-all by shadowing any existing symbol macros
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3192 ;; when we descend let forms or arglist lambdas. Doing it
6c76f5b7e2e3 Be more careful still in #'cl-defsubst-expand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5569
diff changeset
3193 ;; unconditionally could well break #'loop, though.
5523
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3194 ,symbol-macros
810b77562486 Improve #'defsubst* a little, document a bug that remains.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5522
diff changeset
3195 ,body)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3196
5379
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3197 ;; 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
3198 ;; 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
3199 ;; 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
3200 ;; 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
3201 ;; 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
3202 (macrolet
5501
4813ff11c6e2 Correct the definition of #'cl-non-fixnum-number-p on 32-bit machines.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5476
diff changeset
3203 ((most-positive-fixnum-on-32-bit-machines () (1- (lsh 1 30)))
4813ff11c6e2 Correct the definition of #'cl-non-fixnum-number-p on 32-bit machines.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5476
diff changeset
3204 (most-negative-fixnum-on-32-bit-machines ()
4813ff11c6e2 Correct the definition of #'cl-non-fixnum-number-p on 32-bit machines.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5476
diff changeset
3205 (lognot (most-positive-fixnum-on-32-bit-machines))))
5659
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3206 (defun cl-non-immediate-number-p (object)
5379
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3207 "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
3208 (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
3209 (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
3210 (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
3211 object
a32a108ae815 #'cl-non-fixnum-number-p: return t for integers > #x3fffffff and < -#x40000000
Aidan Kehoe <kehoea@parhasard.net>
parents: 5376
diff changeset
3212 (most-positive-fixnum-on-32-bit-machines)))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3213
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3214 ;;; Compile-time optimizations for some functions defined in this package.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3215 ;;; 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
3216 ;;; mainly to make sure these macros will be present.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3217
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3218 (define-compiler-macro eql (&whole form a b)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3219 (cond ((eq (cl-const-expr-p a) t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3220 (let ((val (cl-const-expr-val a)))
5659
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3221 (if (cl-non-immediate-number-p val)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3222 (list 'equal a b)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3223 (list 'eq a b))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3224 ((eq (cl-const-expr-p b) t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3225 (let ((val (cl-const-expr-val b)))
5659
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3226 (if (cl-non-immediate-number-p val)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3227 (list 'equal a b)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3228 (list 'eq a b))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3229 (t form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3230
5659
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3231 (defun cl-equal-equivalent-to-eq-p (object)
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3232 (or (symbolp object) (characterp object)
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3233 (and (fixnump object) (not (cl-non-immediate-number-p object)))))
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3234
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3235 (defun cl-car-or-pi (object)
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3236 (if (consp object) (car object) pi))
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3237
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3238 (defun cl-cdr-or-pi (object)
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3239 (if (consp object) (cdr object) pi))
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3240
5694
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3241 (define-compiler-macro equal (&whole form &rest args)
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3242 (cond
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3243 ((not (eql (length form) 3))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3244 form)
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3245 ((or (cl-equal-equivalent-to-eq-p (cl-const-expr-val (pop args) pi))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3246 (cl-equal-equivalent-to-eq-p (cl-const-expr-val (pop args) pi)))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3247 (cons 'eq (cdr form)))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3248 (t form)))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3249
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3250 (define-compiler-macro member (&whole form &rest args)
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3251 (cond
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3252 ((not (eql (length form) 3))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3253 form)
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3254 ((or (cl-equal-equivalent-to-eq-p (cl-const-expr-val (pop args) pi))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3255 (every #'cl-equal-equivalent-to-eq-p
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3256 (cl-const-expr-val (pop args) '(1.0))))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3257 (cons 'memq (cdr form)))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3258 (t form)))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3259
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3260 (define-compiler-macro assoc (&whole form &rest args)
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3261 (cond
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3262 ((not (eql (length form) 3))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3263 form)
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3264 ((or (cl-equal-equivalent-to-eq-p (cl-const-expr-val (pop args) pi))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3265 (not (find-if-not #'cl-equal-equivalent-to-eq-p
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3266 (cl-const-expr-val (pop args) '((1.0 . nil)))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3267 :key #'cl-car-or-pi)))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3268 (cons 'assq (cdr form)))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3269 (t form)))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3270
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3271 (define-compiler-macro rassoc (&whole form &rest args)
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3272 (cond
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3273 ((not (eql (length form) 3))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3274 form)
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3275 ((or (cl-equal-equivalent-to-eq-p (cl-const-expr-val (pop args) pi))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3276 (not (find-if-not #'cl-equal-equivalent-to-eq-p
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3277 (cl-const-expr-val (pop args) '((nil . 1.0)))
5659
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3278 :key #'cl-cdr-or-pi)))
5694
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3279 (cons 'rassq (cdr form)))
7f4c8574a590 No error from an incorrect number of arguments, recently-added compiler macros
Aidan Kehoe <kehoea@parhasard.net>
parents: 5660
diff changeset
3280 (t form)))
5659
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3281
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3282 (macrolet
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3283 ((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
3284 "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
3285 :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
3286 (list*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3287 'progn
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3288 (mapcar
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3289 (function*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3290 (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
3291 `(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
3292 (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
3293 form
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3294 (condition-case nil
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3295 (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
3296 (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
3297 (list (pop keys))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3298 (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
3299 (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
3300 (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
3301 (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
3302 (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
3303 (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
3304 form
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3305 (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
3306 ((eq test 'equal)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3307 `(,',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
3308 ((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
3309 (not (eq not-constant item-val)))
5659
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3310 (if (cl-non-immediate-number-p item-val)
5329
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3311 `(,',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
3312 `(,',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
3313 ((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
3314 list-val)))
5659
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3315 (if (some 'cl-non-immediate-number-p list-val)
5329
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3316 `(,',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
3317 ;; 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
3318 ;; 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
3319 ;; 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
3320 ;; 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
3321 `(,',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
3322 ;; 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
3323 ;; 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
3324 ((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
3325 (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
3326 (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
3327 (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
3328 `(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
3329 (,',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
3330 ,(second test-expr))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3331 (,',star-function
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3332 ,item ,list :test
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3333 ,(third test-expr)))))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3334 (t form)))))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3335 ;; 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
3336 ;; #'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
3337 (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
3338 macros))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3339 (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
3340 (member* memq member)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3341 (assoc* assq assoc)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3342 (rassoc* rassq rassoc)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3343
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3344 (define-compiler-macro adjoin (&whole form a list &rest keys)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3345 (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
3346 (not (memq :key keys)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3347 (list 'if (list* 'member* a list keys) list (list 'cons a list))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3348 form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3349
5338
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3350 (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
3351 (if (eql 3 (length form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3352 (symbol-macrolet ((not-constant '#:not-constant))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3353 (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
3354 (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
3355 (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
3356 (characterp cl-const-expr-val)))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3357 (cons 'delete* (cdr form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3358 `(delete* ,@(cdr form) :test #'equal))))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3359 form))
5338
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3360
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3361 (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
3362 (if (eql 3 (length form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3363 (symbol-macrolet
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3364 ((not-constant '#:not-constant))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3365 (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
3366 (if (and (cdr form) (not (eq not-constant cl-const-expr-val))
5659
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3367 (not (cl-non-immediate-number-p cl-const-expr-val)))
5346
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3368 (cons 'delete* (cdr form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3369 `(delete* ,@(cdr form) :test #'eq))))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3370 form))
5338
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3371
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3372 (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
3373 (if (eql 3 (length form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3374 (symbol-macrolet
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3375 ((not-constant '#:not-constant))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3376 (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
3377 (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
3378 (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
3379 (characterp cl-const-expr-val)))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3380 (cons 'remove* (cdr form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3381 `(remove* ,@(cdr form) :test #'equal))))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3382 form))
5338
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3383
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3384 (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
3385 (if (eql 3 (length form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3386 (symbol-macrolet
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3387 ((not-constant '#:not-constant))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3388 (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
3389 (if (and (cdr form) (not (eq not-constant cl-const-expr-val))
5659
e63bb7b22c8f Add compiler macros for #'equal, #'member, ... where #'eq, #'memq appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5658
diff changeset
3390 (not (cl-non-immediate-number-p cl-const-expr-val)))
5346
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3391 (cons 'remove* (cdr form))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3392 `(remove* ,@(cdr form) :test #'eq))))
b4ef3128160c Fix some testsuite failures, #'delete, #'delq, #'remove, #'remq.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5342
diff changeset
3393 form))
5338
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3394
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3395 (macrolet
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3396 ((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
3397 "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
3398 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
3399 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
3400 (cons
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3401 'progn
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3402 (mapcar
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3403 (function*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3404 (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
3405 (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
3406 "not")
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3407 :if-not
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3408 :if)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3409 `(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
3410 (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
3411 (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
3412 (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
3413 ;; 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
3414 ;; 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
3415 ;; 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
3416 `(,',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
3417 ,(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
3418 form)))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3419 alist))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3420 (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
3421 (remove-if . remove*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3422 (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
3423 (delete-if . delete*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3424 (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
3425 (find-if . find)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3426 (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
3427 (position-if . position)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3428 (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
3429 (count-if . count)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3430 (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
3431 (member-if . member*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3432 (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
3433 (assoc-if . assoc*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3434 (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
3435 (rassoc-if . rassoc*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3436 (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
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-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
3440 "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
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 ,(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
3455 ,,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
3456 form)))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3457 alist))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3458 (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
3459 (substitute-if . substitute)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3460 (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
3461 (nsubstitute-if . nsubstitute)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3462 (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
3463
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3464 (macrolet
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3465 ((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
3466 "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
3467 (cons
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3468 'progn
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3469 (mapcar
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3470 (function*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3471 (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
3472 (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
3473 "not")
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3474 :if-not
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3475 :if)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3476 `(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
3477 (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
3478 (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
3479 (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
3480 `(,',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
3481 `'((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
3482 (second form))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3483 `(list (cons ',',function
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3484 ,(second form))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3485 ,(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
3486 ,@(nthcdr 4 form))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3487 form)))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3488 alist))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3489 (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
3490 (subst-if . sublis)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3491 (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
3492 (nsubst-if . nsublis)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3493 (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
3494
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3495 (define-compiler-macro list* (arg &rest others)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3496 (let* ((args (reverse (cons arg others)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3497 (form (car args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3498 (while (setq args (cdr args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3499 (setq form (list 'cons (car args) form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3500 form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3501
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3502 ;; XEmacs change: our builtin get takes the default argument
440
8de8e3f6228a Import from CVS: tag r21-2-28
cvs
parents: 428
diff changeset
3503 (define-compiler-macro get* (sym prop &optional default)
8de8e3f6228a Import from CVS: tag r21-2-28
cvs
parents: 428
diff changeset
3504 (list 'get sym prop default))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3505
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
3506 (define-compiler-macro getf (sym prop &optional default)
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
3507 (list 'plist-get sym prop default))
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
3508
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3509 (define-compiler-macro typep (&whole form val type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3510 (if (cl-const-expr-p type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3511 (let ((res (cl-make-type-test val (cl-const-expr-val type))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3512 (if (or (memq (cl-expr-contains res val) '(nil 1))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3513 (cl-simple-expr-p val)) res
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3514 (let ((temp (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3515 (list 'let (list (list temp val)) (subst temp val res)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3516 form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3517
5550
b908c7265a2b Add the #'apply-partially API, as used by GNU.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5525
diff changeset
3518 (define-compiler-macro apply-partially (&whole form &rest args)
b908c7265a2b Add the #'apply-partially API, as used by GNU.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5525
diff changeset
3519 "Generate a #'make-byte-code call for #'apply-partially, if appropriate."
5737
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3520 (when (< (length args) 1)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3521 (return-from apply-partially form))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3522 (let* ((values (cdr args)) (count (length values))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3523 (placeholders (mapcar #'quote-maybe (mapcar #'gensym values)))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3524 (sublis (pairlis placeholders values))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3525 restp lambda arglist bindings compiled)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3526 (when (and (eq 'function (car-safe (nth 0 args)))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3527 (eq 'lambda (car-safe (nth 1 (nth 0 args)))))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3528 (setq lambda (nth 1 (nth 0 args))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3529 arglist (nth 1 lambda))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3530 (when (> count (function-max-args lambda))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3531 (byte-compile-warn
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3532 "attempt to apply-partially %S with too many arguments" lambda)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3533 (return-from apply-partially form))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3534 (while (and arglist placeholders)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3535 (cond ((eq (car arglist) '&optional)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3536 (if restp
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3537 (error 'syntax-error
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3538 "&optional found after &rest in %S" lambda))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3539 (if (null (cdr arglist))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3540 (error 'syntax-error "nothing after &optional in %S"
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3541 lambda)))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3542 ((eq (car arglist) '&rest)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3543 (if (null (cdr arglist))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3544 (error 'syntax-error "nothing after &rest in %S" lambda))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3545 (if (cdr (cdr arglist))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3546 (error 'syntax-error "multiple vars after &rest in %S"
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3547 lambda))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3548 (setq restp t))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3549 (restp
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3550 (setq bindings (cons (list (car arglist)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3551 (and placeholders
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3552 (cons 'list placeholders)))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3553 bindings)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3554 placeholders nil))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3555 (t
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3556 (setq bindings (cons (list (car arglist) (car placeholders))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3557 bindings)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3558 placeholders (cdr placeholders))))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3559 (setq arglist (cdr arglist)))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3560 (when (cl-const-exprs-p values)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3561 ;; Values are constant, no need to construct the compiled function
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3562 ;; at runtime.
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3563 (return-from apply-partially
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3564 (byte-compile-lambda
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3565 `(lambda ,arglist (let ,(sublis sublis (nreverse bindings)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3566 :test #'equal)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3567 ,@(cddr lambda))))))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3568 (setq compiled (byte-compile-lambda
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3569 `(lambda ,arglist (let ,(nreverse bindings)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3570 ,@(cddr lambda)))))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3571 (return-from apply-partially
5550
b908c7265a2b Add the #'apply-partially API, as used by GNU.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5525
diff changeset
3572 `(make-byte-code
b908c7265a2b Add the #'apply-partially API, as used by GNU.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5525
diff changeset
3573 ',(compiled-function-arglist compiled)
b908c7265a2b Add the #'apply-partially API, as used by GNU.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5525
diff changeset
3574 ,(compiled-function-instructions compiled)
5737
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3575 (vector ,@(sublis sublis
5550
b908c7265a2b Add the #'apply-partially API, as used by GNU.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5525
diff changeset
3576 (mapcar 'quote-maybe
b908c7265a2b Add the #'apply-partially API, as used by GNU.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5525
diff changeset
3577 (compiled-function-constants compiled))
b908c7265a2b Add the #'apply-partially API, as used by GNU.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5525
diff changeset
3578 :test 'equal))
5737
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3579 ,(compiled-function-stack-depth compiled))))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3580 (if (cl-const-exprs-p args)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3581 `#'(lambda (&rest args) (apply ,@args args))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3582 (let* ((placeholders (mapcar 'quote-maybe (mapcar 'gensym args)))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3583 (compiled (byte-compile-sexp
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3584 `#'(lambda (&rest args)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3585 (apply ,@placeholders args)))))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3586 (assert (equal (intersection
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3587 (mapcar 'quote-maybe (compiled-function-constants
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3588 compiled))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3589 placeholders :test 'equal :stable t)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3590 placeholders)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3591 t "This macro requires that the relative order is the same\
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3592 in the constants vector and in the arguments")
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3593 `(make-byte-code
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3594 ',(compiled-function-arglist compiled)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3595 ,(compiled-function-instructions compiled)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3596 (vector ,@(sublis (pairlis placeholders args)
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3597 (mapcar 'quote-maybe
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3598 (compiled-function-constants compiled))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3599 :test 'equal))
165315eae1ab Make #'apply-partially more intelligent still when byte-compiled.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5694
diff changeset
3600 ,(compiled-function-stack-depth compiled))))))
5550
b908c7265a2b Add the #'apply-partially API, as used by GNU.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5525
diff changeset
3601
5085
1ee30d3f9dd0 Handle the :from-end argument correctly, #'delete-duplicates compiler macro.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5084
diff changeset
3602 (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
3603 `(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
3604
1ee30d3f9dd0 Handle the :from-end argument correctly, #'delete-duplicates compiler macro.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5084
diff changeset
3605 ;; 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
3606 ;; 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
3607 ;; 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
3608 (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
3609 (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
3610 (if (or
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3611 (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
3612 ;; 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
3613 ;; 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
3614 ;; 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
3615 '(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
3616 (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
3617 ;; 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
3618 (not (cdr form)))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3619 form
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3620 (cond
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3621 ((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
3622 (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
3623 `(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
3624 cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3625 (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
3626 (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
3627 (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
3628 (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
3629 (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
3630 (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
3631 (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
3632 begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3633 ((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
3634 (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
3635 `(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
3636 (cl-seq begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3637 (while cl-seq
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3638 (setq cl-seq (setcdr cl-seq
5652
cc6f0266bc36 Avoid #'delq in core Lisp, for the sake of style, a very slightly smaller binary
Aidan Kehoe <kehoea@parhasard.net>
parents: 5651
diff changeset
3639 (delete* (car cl-seq) (cdr cl-seq)))))
5317
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3640 begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3641 ((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
3642 (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
3643 `(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
3644 cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3645 (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
3646 (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
3647 (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
3648 (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
3649 (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
3650 (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
3651 (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
3652 begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3653 ((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
3654 (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
3655 `(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
3656 (cl-seq begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3657 (while cl-seq
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3658 (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
3659 (cdr cl-seq)))))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3660 begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3661 (t form)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3662
4723
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3663 ;; 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
3664 ;; 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
3665 ;; 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
3666 (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
3667 (if (stringp string)
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3668 (regexp-quote string)
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3669 form))
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3670
4906
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3671 ;; 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
3672 ;; 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
3673 ;; 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
3674 ;; 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
3675 ;; 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
3676 ;; 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
3677 ;; 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
3678 ;; 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
3679 ;; 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
3680 ;; 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
3681 ;; 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
3682 ;; 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
3683 ;;
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3684 ;; --ben
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3685
4792
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3686 (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
3687 "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
3688
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3689 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
3690 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
3691 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
3692
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3693 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
3694 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
3695 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
3696 ;; 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
3697 ;; 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
3698 ;; 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
3699 (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
3700 (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
3701 (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
3702 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
3703 (macrolet
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3704 ((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
3705 `(prog1
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3706 (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
3707 (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
3708 (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
3709 (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
3710 (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
3711 (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
3712 (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
3713 ;; 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
3714 ;; 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
3715 ;; 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
3716 (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
3717 ;; 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
3718 ;; 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
3719 ;; 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
3720 ;; 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
3721 (cond
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3722 ((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
3723 ;; 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
3724 `(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
3725 (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
3726 ((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
3727 `(,@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
3728 (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
3729 (= ,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
3730 ((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
3731 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
3732 ((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
3733 ;; 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
3734 (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
3735 (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
3736 (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
3737 (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
3738
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3739 ;; 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
3740 ;; 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
3741 ;; 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
3742 ;; 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
3743 ;; 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
3744 ;; 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
3745 ;; 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
3746 ;;((unordered-check
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3747 ;; ;; 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
3748 ;; ;; 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
3749 ;; ;; 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
3750 ;; (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
3751 ;; (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
3752 ;; ;; 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
3753 ;; (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
3754
4792
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3755 ;; 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
3756 ;; 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
3757 ;; 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
3758 (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
3759
4997
8800b5350a13 Move #'some, #'every to C, implementing them with mapcarX.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4996
diff changeset
3760 (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
3761 `(not (some ,@(cdr form))))
4997
8800b5350a13 Move #'some, #'every to C, implementing them with mapcarX.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4996
diff changeset
3762
8800b5350a13 Move #'some, #'every to C, implementing them with mapcarX.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4996
diff changeset
3763 (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
3764 `(not (every ,@(cdr form))))
4997
8800b5350a13 Move #'some, #'every to C, implementing them with mapcarX.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4996
diff changeset
3765
5056
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3766 (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
3767 (cond
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3768 ((< (length form) 2)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3769 ;; Error at runtime:
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3770 form)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3771 ((cl-const-exprs-p (cdr form))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3772 `#'(lambda (&rest ignore) (values ,@(cdr form))))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3773 (t
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3774 (let* ((num-values (length (cdr form)))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3775 (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
3776 (placeholders (loop
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3777 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
3778 collect (make-symbol (format "%d" i))))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3779 (compiled
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3780 (byte-compile-sexp
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3781 `#'(lambda (&rest ignore)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3782 ;; 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
3783 ;; constants vector:
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3784 (values ,@(mapcar #'quote-maybe placeholders)))))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3785 position)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3786 `(make-byte-code '(&rest ignore)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3787 ,(compiled-function-instructions compiled)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3788 (vector ,@(loop
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3789 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
3790 collect (if (setq position
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3791 (position constant placeholders))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3792 (prog2
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3793 (incf (aref placeholders-counts position))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3794 (nth position (cdr form)))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3795 (quote-maybe constant))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3796 finally
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3797 (assert (every #'zerop placeholders-counts)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3798 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
3799 ,(compiled-function-stack-depth compiled))))))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3800
5182
2e528066e2fc Move #'sort*, #'fill, #'merge to C from cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5153
diff changeset
3801 (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
3802 (cons 'sort* (cdr form)))
2e528066e2fc Move #'sort*, #'fill, #'merge to C from cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5153
diff changeset
3803
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3804 (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
3805 (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
3806
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3807 (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
3808 `(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
3809
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3810 (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
3811 `(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
3812
5380
919c77c567bb Add compiler macros for #'revappend, #'nreconc.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5379
diff changeset
3813 (define-compiler-macro revappend (&whole form &rest args)
919c77c567bb Add compiler macros for #'revappend, #'nreconc.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5379
diff changeset
3814 (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
3815
919c77c567bb Add compiler macros for #'revappend, #'nreconc.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5379
diff changeset
3816 (define-compiler-macro nreconc (&whole form &rest args)
919c77c567bb Add compiler macros for #'revappend, #'nreconc.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5379
diff changeset
3817 (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
3818
5226
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3819 (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
3820 (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
3821 (cond
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3822 ((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
3823 (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
3824 ((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
3825 (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
3826 (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
3827 (cfa (compiled-function-arglist cf))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3828 (do-apply (memq '&rest cfa)))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3829 `#'(lambda ,cfa
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3830 (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
3831 ,@(remq '&optional
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3832 (remq '&rest cfa)))))))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3833 (t
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3834 `#'(lambda (&rest arguments)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3835 (not (apply ,fn arguments)))))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3836 ;; 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
3837 (destructuring-bind
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3838 (arglist instructions constants stack-depth)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3839 (let ((compiled-lambda
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3840 (byte-compile-sexp
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3841 #'(lambda (&rest arguments)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3842 (not (apply 'placeholder arguments))))))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3843 (list
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3844 (compiled-function-arglist compiled-lambda)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3845 (compiled-function-instructions compiled-lambda)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3846 (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
3847 (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
3848 `(make-byte-code
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3849 ',arglist ,instructions (vector
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3850 ,@(nsublis
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3851 (list (cons (quote-maybe
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3852 'placeholder)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3853 fn))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3854 (mapcar #'quote-maybe constants)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3855 :test #'equal))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3856 ,stack-depth))))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3857
5242
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3858 (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
3859 (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
3860 '(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
3861 (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
3862 (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
3863 (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
3864 (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
3865 (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
3866 form))
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3867
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3868 (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
3869 string &optional inplace)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3870 (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
3871 `(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
3872 (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
3873 form))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3874
5522
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3875 (define-compiler-macro assoc-ignore-case (&whole form &rest args)
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3876 (if (eql 2 (length args))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3877 `(assoc* (the string ,(pop args))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3878 (the (and list (satisfies
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3879 (lambda (list)
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3880 (not (find-if-not 'stringp list :key 'car)))))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3881 ,(pop args))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3882 :test 'equalp)
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3883 form))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3884
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3885 (define-compiler-macro assoc-ignore-representation (&whole form &rest args)
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3886 (if (eql 2 (length args))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3887 `(assoc* (the string ,(pop args))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3888 (the (and list (satisfies
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3889 (lambda (list)
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3890 (not (find-if-not 'stringp list :key 'car)))))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3891 ,(pop args))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3892 :test 'equalp)
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3893 form))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3894
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3895 (define-compiler-macro member-ignore-case (&whole form &rest args)
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3896 (if (eql 2 (length args))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3897 `(member* (the string ,(pop args))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3898 (the (and list (satisfies
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3899 (lambda (list) (every 'stringp list))))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3900 ,(pop args))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3901 :test 'equalp)
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3902 form))
544e6336d37c Reimplement a few GNU functions in terms of CL functions, subr.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5514
diff changeset
3903
5329
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3904 (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
3905 (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
3906 (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
3907 form))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3908
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3909 (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
3910 (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
3911 (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
3912 form))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3913
5775
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3914 (define-compiler-macro princ (&whole form object &optional stream)
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3915 "When passing `princ' a string, call `write-sequence' instead.
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3916
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3917 This avoids the resource- and time-intensive initialization of the printer,
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3918 and functions equivalently. Such code will not run on 21.4, but 21.4 will
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3919 not normally encounter it, and the error message will be clear enough (that
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3920 `write-sequence' has a void function definition) in the odd event that it
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3921 does."
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3922 (cond ((not (<= 2 (length form) 3))
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3923 form)
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3924 ((or (stringp object)
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3925 (member (car-safe object)
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3926 '(buffer-string buffer-substring concat format gettext
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3927 key-description make-string mapconcat
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3928 substitute-command-keys substring-no-properties
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3929 symbol-name text-char-description string)))
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3930 (cons 'write-sequence (cdr form)))
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3931 ((member (car-safe object) '(substring subseq))
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3932 `(write-sequence ,(nth 1 object) ,stream :start ,(nth 2 object)
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3933 ,@(if (nth 3 object) `((:end ,(nth 3 object))))))
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3934 (t form)))
4004c3266c09 Transform #'princ to #'write-sequence at compile time if appropriate.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5737
diff changeset
3935
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
3936 (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
3937 #'(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
3938 ;; 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
3939 ;; 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
3940 ;; 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
3941 ;; 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
3942 (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
3943 #'(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
3944 (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
3945 (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
3946 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
3947 (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
3948 #'(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
3949 (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
3950 `((,(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
3951 ,(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
3952 (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
3953 '(= < > <= >=))
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
3954
5313
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3955 ;; 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
3956 ;; 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
3957 (macrolet
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3958 ((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
3959 (cons
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3960 'progn
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3961 (loop
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3962 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
3963 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
3964 (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
3965 ,(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
3966 (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
3967 `(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
3968 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
3969 (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
3970 (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
3971 (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
3972 (fifth 'nth 4 x) (sixth 'nth 5 x) (seventh 'nth 6 x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3973 (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
3974 (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
3975 (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
3976 (evenp 'eql (list 'logand x 1) 0)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3977 (caar car car) (cadr car cdr) (cdar cdr car) (cddr cdr cdr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3978 (caaar car caar) (caadr car cadr) (cadar car cdar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3979 (caddr car cddr) (cdaar cdr caar) (cdadr cdr cadr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3980 (cddar cdr cdar) (cdddr cdr cddr) (caaaar car caaar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3981 (caaadr car caadr) (caadar car cadar) (caaddr car caddr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3982 (cadaar car cdaar) (cadadr car cdadr) (caddar car cddar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3983 (cadddr car cdddr) (cdaaar cdr caaar) (cdaadr cdr caadr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3984 (cdadar cdr cadar) (cdaddr cdr caddr) (cddaar cdr cdaar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3985 (cddadr cdr cdadr) (cdddar cdr cddar) (cddddr cdr cdddr)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3986
5339
ba62563ec7c7 Accept more complex TYPEs in #'concatenate, cl-extra.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5338
diff changeset
3987 ;;; 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
3988 ;;; 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
3989 (proclaim '(inline cl-set-elt))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3990
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3991 ;;; Things that are side-effect-free. Moved to byte-optimize.el
5580
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
3992 ;[...]
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3993
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3994 ;;; Things that are side-effect-and-error-free. Moved to byte-optimize.el
5580
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
3995 ;[...]
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
3996
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
3997 ;; XEmacs; move the following macros to the end of this file, since the
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
3998 ;; override the versions in byte-compile-initial-macro-environment for the
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
3999 ;; duration of the file they're defined in.
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4000
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4001 ;;;###autoload
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4002 (defmacro the (type form)
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4003 "Assert that FORM gives a result of type TYPE, and return that result.
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4004
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4005 TYPE is a Common Lisp type specifier.
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4006
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4007 If macro expansion of a `the' form happens during byte compilation, and the
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4008 byte compiler customization variable `byte-compile-delete-errors' is
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4009 non-nil, `the' is equivalent to FORM without any type checks."
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4010 (if (cl-safe-expr-p form)
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4011 `(prog1 ,form (assert ,(cl-make-type-test form type) t))
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4012 (let ((saved (gensym)))
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4013 `(let ((,saved ,form))
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4014 (prog1 ,saved (assert ,(cl-make-type-test saved type) t))))))
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4015
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4016 ;;;###autoload
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4017 (defmacro declare (&rest specs)
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4018 nil)
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4019
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4020 ;;;###autoload
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4021 (defmacro load-time-value (form &optional read-only)
5609
3152c2c21461 Correct and clarify docstring, #'load-time-value
Aidan Kehoe <kehoea@parhasard.net>
parents: 5580
diff changeset
4022 "Evaluate FORM once at load time if byte-compiled.
3152c2c21461 Correct and clarify docstring, #'load-time-value
Aidan Kehoe <kehoea@parhasard.net>
parents: 5580
diff changeset
4023
3152c2c21461 Correct and clarify docstring, #'load-time-value
Aidan Kehoe <kehoea@parhasard.net>
parents: 5580
diff changeset
4024 The result of FORM is returned and stored for later access. In
3152c2c21461 Correct and clarify docstring, #'load-time-value
Aidan Kehoe <kehoea@parhasard.net>
parents: 5580
diff changeset
4025 interpreted code, `load-time-value' is equivalent to `progn'."
5580
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4026 (list 'progn form))
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4027
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4028 ;;;###autoload
5658
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
4029 (defmacro* labels (bindings &rest body &environment env)
5580
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4030 "Make temporary function bindings.
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4031
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4032 This is like `flet', except the bindings are lexical instead of dynamic.
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4033 Unlike `flet', this macro is compliant with the Common Lisp standard with
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4034 regard to the scope and extent of the function bindings.
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4035
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4036 Each function may be called from within FORM, from within the BODY of the
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4037 function itself (that is, recursively), and from any other function bodies
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4038 in FUNCTIONS.
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4039
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4040 Within FORM, to access the function definition of a bound function (for
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4041 example, to pass it as a FUNCTION argument to `map'), quote its symbol name
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4042 using `function'.
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4043
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4044 arguments: (((FUNCTION ARGLIST &body BODY) &rest FUNCTIONS) &body FORM)
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4045 "
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4046 ;; XEmacs; the byte-compiler has a much better implementation of `labels'
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4047 ;; in `byte-compile-initial-macro-environment' that is used in compiled
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4048 ;; code.
5658
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
4049 (let ((vars nil) (sets nil))
5580
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4050 (while bindings
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4051 (let ((var (gensym)))
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4052 (push var vars)
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4053 (push `#'(lambda ,@(cdr (cl-transform-lambda (cdar bindings)
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4054 (caar bindings)))) sets)
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4055 (push var sets)
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4056 (push (list (car (pop bindings)) 'lambda '(&rest cl-labels-args)
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4057 (list 'list* '(quote funcall) (list 'quote var)
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4058 'cl-labels-args))
5658
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
4059 env)))
289cf21be887 Don't augment ENVIRONMENT when that's not indicated, #'macroexpand.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5656
diff changeset
4060 (cl-macroexpand-all `(lexical-let ,vars (setq ,@sets) ,@body) env)))
5580
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4061
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4062 ;;;###autoload
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4063 (defmacro flet (functions &rest form)
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4064 "Make temporary function definitions.
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4065
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4066 This is an analogue of `let' that operates on the function cell of FUNC
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4067 rather than its value cell. The FORMs are evaluated with the specified
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4068 function definitions in place, then the definitions are undone (the FUNCs go
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4069 back to their previous definitions, or lack thereof). This is in
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4070 contravention of Common Lisp, where `flet' makes a lexical, not a dynamic,
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4071 function binding.
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4072
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4073 Normally you should use `labels', not `flet'; `labels' does not have the
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4074 problems caused by dynamic scope, is less expensive when byte-compiled, and
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4075 allows lexical shadowing of functions with byte-codes and byte-compile
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4076 methods, where `flet' will fail. The byte-compiler will warn when this
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4077 happens.
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4078
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4079 If you need to shadow some existing function at run time, and that function
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4080 has no associated byte code or compiler macro, then `flet' is appropriate.
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4081
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4082 arguments: (((FUNCTION ARGLIST &body BODY) &rest FUNCTIONS) &body FORM)"
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4083 ;; XEmacs; leave warnings, errors and modifications of
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4084 ;; byte-compile-function-environment to the byte compiler. See
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4085 ;; byte-compile-initial-macro-environment in bytecomp.el.
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4086 (list*
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4087 'letf*
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4088 (mapcar
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4089 (function*
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4090 (lambda ((function . definition))
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4091 `((symbol-function ',function)
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4092 ,(cons 'lambda (cdr (cl-transform-lambda definition function))))))
a0e81357194e Move macros with shadows in bytecomp.el to the end of the files, cl-macs
Aidan Kehoe <kehoea@parhasard.net>
parents: 5574
diff changeset
4093 functions) form))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
4094
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
4095 (run-hooks 'cl-macs-load-hook)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
4096
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
4097 ;;; arch-tag: afd947a6-b553-4df1-bba5-000be6388f46
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
4098 ;;; cl-macs.el ends here