annotate lisp/cl-macs.el @ 5338:8608eadee6ba

Move #'delq, #'delete to Lisp, adding support for sequences. src/ChangeLog addition: 2011-01-11 Aidan Kehoe <kehoea@parhasard.net> * device-msw.c (Fmswindows_printer_list): Remove a Fdelete () call here, remove the necessity for it. * fns.c (Fdelete, Fdelq): * lisp.h: Move #'delete, #'delq to Lisp, implemented in terms of #'delete* * select.c (Fown_selection_internal): * select.c (handle_selection_clear): Use delq_no_quit() in these functions, don't reimplement it or use Fdelq(), which is now gone. lisp/ChangeLog addition: 2011-01-11 Aidan Kehoe <kehoea@parhasard.net> * subr.el (delete, delq, remove, remq): Move #'remove, #'remq here, they don't belong in cl-seq.el; move #'delete, #'delq here from fns.c, implement them in terms of #'delete*, allowing support for sequences generally. * update-elc.el (do-autoload-commands): Use #'delete*, not #'delq here, now the latter's no longer dumped. * cl-macs.el (delete, delq): Add compiler macros transforming #'delete and #'delq to #'delete* calls.
author Aidan Kehoe <kehoea@parhasard.net>
date Fri, 14 Jan 2011 23:35:29 +0000
parents 7b391d07b334
children ba62563ec7c7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
613
023b83f4e54b [xemacs-hg @ 2001-06-10 10:42:16 by ben]
ben
parents: 452
diff changeset
1 ;;; cl-macs.el --- Common Lisp extensions for XEmacs Lisp (part four)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3 ;; Copyright (C) 1993, 2003, 2004 Free Software Foundation, Inc.
4906
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
4 ;; Copyright (C) 2002, 2010 Ben Wing.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
5
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
6 ;; Author: Dave Gillespie <daveg@synaptics.com>
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
7 ;; Version: 2.02
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
8 ;; Keywords: extensions
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
9
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
10 ;; This file is part of XEmacs.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
11
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
12 ;; XEmacs is free software; you can redistribute it and/or modify it
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
13 ;; under the terms of the GNU General Public License as published by
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
14 ;; the Free Software Foundation; either version 2, or (at your option)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
15 ;; any later version.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
16
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
17 ;; XEmacs is distributed in the hope that it will be useful, but
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
18 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
20 ;; General Public License for more details.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
21
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
22 ;; You should have received a copy of the GNU General Public License
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
23 ;; along with XEmacs; see the file COPYING. If not, write to the Free
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
24 ;; Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
25 ;; 02111-1307, USA.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
26
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
27 ;;; Synched up with: FSF 21.3.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
28
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
29 ;;; Commentary:
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
30
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
31 ;; These are extensions to Emacs Lisp that provide a degree of
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
32 ;; Common Lisp compatibility, beyond what is already built-in
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
33 ;; in Emacs Lisp.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
34 ;;
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
35 ;; This package was written by Dave Gillespie; it is a complete
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
36 ;; rewrite of Cesar Quiroz's original cl.el package of December 1986.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
37 ;;
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
38 ;; Bug reports, comments, and suggestions are welcome!
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
39
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
40 ;; This file contains the portions of the Common Lisp extensions
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
41 ;; package which should be autoloaded, but need only be present
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
42 ;; if the compiler or interpreter is used---this file is not
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
43 ;; necessary for executing compiled code.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
44
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
45 ;; See cl.el for Change Log.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
46
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
47
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
48 ;;; Code:
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
49
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
50 (or (memq 'cl-19 features)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
51 (error "Tried to load `cl-macs' before `cl'!"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
52
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
53
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
54 (defmacro cl-pop2 (place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
55 (list 'prog1 (list 'car (list 'cdr place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
56 (list 'setq place (list 'cdr (list 'cdr place)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
57 (put 'cl-pop2 'edebug-form-spec 'edebug-sexps)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
58
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
59 (defvar cl-optimize-safety)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
60 (defvar cl-optimize-speed)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
61
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
62
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
63 ;;; This kludge allows macros which use cl-transform-function-property
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
64 ;;; to be called at compile-time.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
65
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
66 (require
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
67 (progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
68 (or (fboundp 'cl-transform-function-property)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
69 (defalias 'cl-transform-function-property
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
70 #'(lambda (n p f)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
71 (list 'put (list 'quote n) (list 'quote p)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
72 (list 'function (cons 'lambda f))))))
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
73 'xemacs))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
74
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
75
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
76 ;;; Initialization.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
77
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
78 (defvar cl-old-bc-file-form nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
79
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
80 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
81 (defun cl-compile-time-init ()
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
82 (run-hooks 'cl-hack-bytecomp-hook))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
83
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
84
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
85 ;;; Some predicates for analyzing Lisp forms. These are used by various
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
86 ;;; macro expanders to optimize the results in certain common cases.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
87
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
88 (defconst cl-simple-funcs '(car cdr nth aref elt if and or + - 1+ 1- min max
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
89 car-safe cdr-safe progn prog1 prog2))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
90 (defconst cl-safe-funcs '(* / % length memq list vector vectorp
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
91 < > <= >= = error))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
92
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
93 ;;; Check if no side effects, and executes quickly.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
94 (defun cl-simple-expr-p (x &optional size)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
95 (or size (setq size 10))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
96 (if (and (consp x) (not (memq (car x) '(quote function function*))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
97 (and (symbolp (car x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
98 (or (memq (car x) cl-simple-funcs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
99 (get (car x) 'side-effect-free))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
100 (progn
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
101 (setq size (1- size))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
102 (while (and (setq x (cdr x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
103 (setq size (cl-simple-expr-p (car x) size))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
104 (and (null x) (>= size 0) size)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
105 (and (> size 0) (1- size))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
106
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
107 (defun cl-simple-exprs-p (xs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
108 (while (and xs (cl-simple-expr-p (car xs)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
109 (setq xs (cdr xs)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
110 (not xs))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
111
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
112 ;;; Check if no side effects.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
113 (defun cl-safe-expr-p (x)
5316
9ac28212c75a #'cl-safe-expr-p, forms that start with the symbol lambda are also safe.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5314
diff changeset
114 (or (not (and (consp x) (not (memq (car x)
9ac28212c75a #'cl-safe-expr-p, forms that start with the symbol lambda are also safe.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5314
diff changeset
115 '(quote function function* lambda)))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
116 (and (symbolp (car x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
117 (or (memq (car x) cl-simple-funcs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
118 (memq (car x) cl-safe-funcs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
119 (get (car x) 'side-effect-free))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
120 (progn
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
121 (while (and (setq x (cdr x)) (cl-safe-expr-p (car x))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
122 (null x)))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
123
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
124 ;;; Check if constant (i.e., no side effects or dependencies).
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
125 (defun cl-const-expr-p (x)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
126 (cond ((consp x)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
127 (or (eq (car x) 'quote)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
128 (and (memq (car x) '(function function*))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
129 (or (symbolp (nth 1 x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
130 (and (eq (car-safe (nth 1 x)) 'lambda) 'func)))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
131 ((symbolp x) (and (memq x '(nil t)) t))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
132 (t t)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
133
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
134 (defun cl-const-exprs-p (xs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
135 (while (and xs (cl-const-expr-p (car xs)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
136 (setq xs (cdr xs)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
137 (not xs))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
138
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
139 (defun cl-const-expr-val (x &optional cl-not-constant)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
140 (let ((cl-const-expr-p (cl-const-expr-p x)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
141 (cond ((eq cl-const-expr-p t) (if (consp x) (nth 1 x) x))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
142 ((eq cl-const-expr-p 'func) (nth 1 x))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
143 (cl-not-constant))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
144
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
145 (defun cl-expr-access-order (x v)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
146 (if (cl-const-expr-p x) v
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
147 (if (consp x)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
148 (progn
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
149 (while (setq x (cdr x)) (setq v (cl-expr-access-order (car x) v)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
150 v)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
151 (if (eq x (car v)) (cdr v) '(t)))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
152
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
153 ;;; Count number of times X refers to Y. Return nil for 0 times.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
154 (defun cl-expr-contains (x y)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
155 (cond ((equal y x) 1)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
156 ((and (consp x) (not (memq (car-safe x) '(quote function function*))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
157 (let ((sum 0))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
158 (while x
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
159 (setq sum (+ sum (or (cl-expr-contains (pop x) y) 0))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
160 (and (> sum 0) sum)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
161 (t nil)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
162
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
163 (defun cl-expr-contains-any (x y)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
164 (while (and y (not (cl-expr-contains x (car y)))) (pop y))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
165 y)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
166
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
167 ;;; Check whether X may depend on any of the symbols in Y.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
168 (defun cl-expr-depends-p (x y)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
169 (and (not (cl-const-expr-p x))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
170 (or (not (cl-safe-expr-p x)) (cl-expr-contains-any x y))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
171
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
172 ;;; Symbols.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
173
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
174 (defvar *gensym-counter*)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
175
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
176 ;; XEmacs change: gensym and gentemp have been moved to cl.el.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
177
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
178
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
179 ;;; Program structure.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
180
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
181 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
182 (defmacro defun* (name arglist &optional docstring &rest body)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
183 "Define NAME as a function.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
184 Like normal `defun', except ARGLIST allows full Common Lisp conventions,
872
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
185 and BODY is implicitly surrounded by (block NAME ...).
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
186
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
187 \"Full Common Lisp conventions\" means that:
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
188
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
189 -- In addition to &optional and &rest, the lambda-list keywords &key,
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
190 &allow-other-keys, and &aux are allowed.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
191
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
192 -- The format of the arguments to &optional is expanded: As well as simple
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
193 variables, they can be lists of the form (VAR [INITFORM [SVAR]]); when
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
194 no argument is available for VAR, INITFORM is evaluated (or nil, if
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
195 INITFORM is omitted) and stored as VAR's value, and SVAR is bound to t.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
196 If an arguent is available for VAR, and INITFORM is unused, SVAR is
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
197 bound to nil.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
198
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
199 -- &key specifies keyword arguments. The format of each argument is
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
200 VAR || ( { VAR || (KEYWORD VAR) } [INITFORM [SVAR]]).
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
201
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
202 If VAR is specified on its own, VAR is bound within BODY to the value
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
203 supplied by the caller for the corresponding keyword; for example, &key
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
204 my-value means callers write :my-value RUNTIME-EXPRESSION.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
205
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
206 If (VAR INITFORM) is specified, INITFORM is an expression evaluated at
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
207 runtime to determine a default value for VAR.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
208
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
209 If (VAR INITFORM SVAR) is specified, SVAR is variable available within
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
210 BODY that is non-nil if VAR was explicitly specified in the calling
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
211 expression.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
212
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
213 If ((KEYWORD VAR)) is specified, KEYWORD is the keyword to be used by
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
214 callers, and VAR is the corresponding variable binding within BODY.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
215
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
216 In calls to NAME, values for a given keyword may be supplied multiple
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
217 times. The first value is the only one used.
872
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
218
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
219 -- &allow-other-keys means that if other keyword arguments are given that are
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
220 not specifically list in the arg list, they are allowed, rather than an
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
221 error being signalled. They can be retrieved with an &rest form.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
222
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
223 -- &aux specifies extra bindings, exactly like a `let*' enclosing the body.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
224 The format of each binding is VAR || (VAR [INITFORM]) -- exactly like the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
225 format of `let'/`let*' bindings.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
226 "
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
227 (let* ((res (cl-transform-lambda (list* arglist docstring body) name))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
228 (form (list* 'defun name (cdr res))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
229 (if (car res) (list 'progn (car res) form) form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
230
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
231 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
232 (defmacro defmacro* (name arglist &optional docstring &rest body)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
233 "Define NAME as a macro.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
234 Like normal `defmacro', except ARGLIST allows full Common Lisp conventions,
872
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
235 and BODY is implicitly surrounded by (block NAME ...).
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
236
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
237 \"Full Common Lisp conventions\" means that:
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
238
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
239 -- The lambda-list keywords &optional, &rest, &key, &allow-other-keys, and
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
240 &aux are allowed, as in `defun*'.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
241
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
242 -- Three additional lambda-list keywords are allowed: &body, &whole, and
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
243 &environment:
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
244
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
245 &body is equivalent to &rest, but is intended to indicate that the
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
246 following arguments are the body of some piece of code, and should be
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
247 indented as such.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
248
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
249 &whole must come first; it is followed by a single variable that, at
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
250 macro expansion time, reflects all the arguments supplied to the macro,
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
251 as if it had been declared with a single &rest argument.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
252
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
253 &environment specifies local semantics for various macros for use within
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
254 the expansion of BODY. See the ENVIRONMENT argument to `macroexpand'.
872
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
255
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
256 -- The macro arg list syntax allows for \"destructuring\" -- see also
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
257 `destructuring-bind', which destructures exactly like `defmacro*', and
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
258 `loop', which does a rather different way of destructuring. Anywhere
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
259 that a simple argument may appear, and (if following a lambda-list
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
260 keyword) a list may not normally appear, an embedded lambda list can be
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
261 substituted. (The format of the embedded lambda list is exactly the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
262 same as for a top-level list except that &environment is not allowed.)
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
263 When matching this lambda list against a caller-specified argument, that
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
264 argument is treated as a list and normal lambda-list processing occurs,
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
265 just as if the entire operation were happening at top level.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
266 Furthermore, any lambda list, embedded or top-level, can be dotted at its
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
267 end, and this will cause matching with an appropriate dotted list given
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
268 as an argument.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
269
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
270 See `loop' for practical examples of destructuring, but
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
271 keep in mind that `loop' destructuring is somewhat different from macro
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
272 destructuring in that
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
273
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
274 (a) Macro destructuring has extra features in the various lambda-list
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
275 keywords, allowing for special processing of a list other than just
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
276 simple matching.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
277 (b) Macro destructuring is strict, in that an error is signalled if the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
278 actual structure does not match the expected structure. On the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
279 other hand, loop destructuring is lax -- extra arguments in a list
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
280 are ignored, not enough arguments cause the remaining parameters to
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
281 receive a value of nil, etc.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
282 "
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
283 (let* ((res (cl-transform-lambda (list* arglist docstring body) name))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
284 (form (list* 'defmacro name (cdr res))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
285 (if (car res) (list 'progn (car res) form) form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
286
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
287 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
288 (defmacro function* (symbol-or-lambda)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
289 "Introduce a function.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
290 Like normal `function', except that if argument is a lambda form, its
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
291 ARGLIST allows full Common Lisp conventions."
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
292 (if (eq (car-safe symbol-or-lambda) 'lambda)
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
293 (let* ((res (cl-transform-lambda (cdr symbol-or-lambda) 'cl-none))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
294 (form (list 'function (cons 'lambda (cdr res)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
295 (if (car res) (list 'progn (car res) form) form))
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
296 (list 'function symbol-or-lambda)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
297
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
298 (defun cl-transform-function-property (func prop form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
299 (let ((res (cl-transform-lambda form func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
300 (append '(progn) (cdr (cdr (car res)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
301 (list (list 'put (list 'quote func) (list 'quote prop)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
302 (list 'function (cons 'lambda (cdr res))))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
303
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
304 (defconst lambda-list-keywords
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
305 '(&optional &rest &key &allow-other-keys &aux &whole &body &environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
306
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
307 (defvar cl-macro-environment nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
308 (defvar bind-block) (defvar bind-defs) (defvar bind-enquote)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
309 (defvar bind-inits) (defvar bind-lets) (defvar bind-forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
310
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
311 ;; npak@ispras.ru
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
312 (defun cl-upcase-arg (arg)
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
313 ;; Changes all non-keyword symbols in `ARG' to symbols
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
314 ;; with name in upper case.
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
315 ;; ARG is either symbol or list of symbols or lists
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
316 (cond ((symbolp arg)
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
317 ;; Do not upcase &optional, &key etc.
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
318 (if (memq arg lambda-list-keywords)
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
319 arg
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
320 (make-symbol (upcase (symbol-name arg)))))
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
321 ((listp arg)
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
322 (let ((arg (copy-list arg)) junk)
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
323 ;; Clean the list
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
324 (let ((p (last arg))) (if (cdr p) (setcdr p (list '&rest (cdr p)))))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
325 (if (setq junk (cadr (memq '&cl-defs arg)))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
326 (setq arg (delq '&cl-defs (delq junk arg))))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
327 (if (memq '&cl-quote arg)
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
328 (setq arg (delq '&cl-quote arg)))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
329 (mapcar 'cl-upcase-arg arg)))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
330 (t arg))) ; Maybe we are in initializer
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
331
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
332 ;; npak@ispras.ru, modified by ben@666.com
4702
eb1a409c317b Unbreak autoload.el
Mike Sperber <sperber@deinprogramm.de>
parents: 4695
diff changeset
333 ;;;###autoload
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
334 (defun cl-function-arglist (arglist)
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
335 "Returns string with printed representation of arguments list.
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
336 Supports Common Lisp lambda lists."
1580
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
337 (if (not (or (listp arglist) (symbolp arglist)))
15a9361e2781 [xemacs-hg @ 2003-07-18 20:39:44 by james]
james
parents: 1346
diff changeset
338 "Not available"
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
339 (check-argument-type #'true-list-p arglist)
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
340 (let ((print-gensym nil))
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
341 (condition-case nil
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
342 (let ((args (cond ((null arglist) nil)
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
343 ((listp arglist) (cl-upcase-arg arglist))
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
344 ((symbolp arglist)
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
345 (cl-upcase-arg (list '&rest arglist)))
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
346 (t (wrong-type-argument 'listp arglist)))))
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
347 (if args (prin1-to-string args) "()"))
5070
b0f4adffca7d fix so that CL docstrings (with &key, etc.) handled properly
Ben Wing <ben@xemacs.org>
parents: 4997
diff changeset
348 (t "Not available")))))
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
349
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
350 (defun cl-transform-lambda (form bind-block)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
351 (let* ((args (car form)) (body (cdr form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
352 (bind-defs nil) (bind-enquote nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
353 (bind-inits nil) (bind-lets nil) (bind-forms nil)
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
354 (header nil) (simple-args nil)
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
355 (complex-arglist (cl-function-arglist args))
452
3d3049ae1304 Import from CVS: tag r21-2-41
cvs
parents: 446
diff changeset
356 (doc ""))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
357 (while (or (stringp (car body)) (eq (car-safe (car body)) 'interactive))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
358 (push (pop body) header))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
359 (setq args (if (listp args) (copy-list args) (list '&rest args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
360 (let ((p (last args))) (if (cdr p) (setcdr p (list '&rest (cdr p)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
361 (if (setq bind-defs (cadr (memq '&cl-defs args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
362 (setq args (delq '&cl-defs (delq bind-defs args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
363 bind-defs (cadr bind-defs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
364 (if (setq bind-enquote (memq '&cl-quote args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
365 (setq args (delq '&cl-quote args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
366 (if (memq '&whole args) (error "&whole not currently implemented"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
367 (let* ((p (memq '&environment args)) (v (cadr p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
368 (if p (setq args (nconc (delq (car p) (delq v args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
369 (list '&aux (list v 'cl-macro-environment))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
370 (while (and args (symbolp (car args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
371 (not (memq (car args) '(nil &rest &body &key &aux)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
372 (not (and (eq (car args) '&optional)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
373 (or bind-defs (consp (cadr args))))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
374 (push (pop args) simple-args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
375 (or (eq bind-block 'cl-none)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
376 (setq body (list (list* 'block bind-block body))))
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
377 (setq simple-args (nreverse simple-args)
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
378 header (nreverse header))
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
379 ;; Add CL lambda list to documentation, if the CL lambda list differs
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
380 ;; from the non-CL lambda list. npak@ispras.ru
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
381 (unless (equal complex-arglist
5076
d555581e3cba fix issues with display of argument docstrings
Ben Wing <ben@xemacs.org>
parents: 5072
diff changeset
382 (cl-function-arglist simple-args))
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
383 (and (stringp (car header)) (setq doc (pop header)))
5070
b0f4adffca7d fix so that CL docstrings (with &key, etc.) handled properly
Ben Wing <ben@xemacs.org>
parents: 4997
diff changeset
384 ;; Stick the arguments onto the end of the doc string in a way that
b0f4adffca7d fix so that CL docstrings (with &key, etc.) handled properly
Ben Wing <ben@xemacs.org>
parents: 4997
diff changeset
385 ;; will be recognized specially by `function-arglist'.
b0f4adffca7d fix so that CL docstrings (with &key, etc.) handled properly
Ben Wing <ben@xemacs.org>
parents: 4997
diff changeset
386 (push (concat doc "\n\narguments: " complex-arglist "\n")
b0f4adffca7d fix so that CL docstrings (with &key, etc.) handled properly
Ben Wing <ben@xemacs.org>
parents: 4997
diff changeset
387 header))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
388 (if (null args)
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
389 (list* nil simple-args (nconc header body))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
390 (if (memq '&optional simple-args) (push '&optional args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
391 (cl-do-arglist args nil (- (length simple-args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
392 (if (memq '&optional simple-args) 1 0)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
393 (setq bind-lets (nreverse bind-lets))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
394 (list* (and bind-inits (list* 'eval-when '(compile load eval)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
395 (nreverse bind-inits)))
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
396 (nconc simple-args
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
397 (list '&rest (car (pop bind-lets))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
398 ;; XEmacs change: we add usage information using Nickolay's
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
399 ;; approach above
4694
2ac296807b88 Don't needlessly intern symbols, #'function-arglist, #'cl-function-arglist
Aidan Kehoe <kehoea@parhasard.net>
parents: 4677
diff changeset
400 (nconc header
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
401 (list (nconc (list 'let* bind-lets)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
402 (nreverse bind-forms) body)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
403
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
404 (defun cl-do-arglist (args expr &optional num) ; uses bind-*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
405 (if (nlistp args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
406 (if (or (memq args lambda-list-keywords) (not (symbolp args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
407 (error "Invalid argument name: %s" args)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
408 (push (list args expr) bind-lets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
409 (setq args (copy-list args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
410 (let ((p (last args))) (if (cdr p) (setcdr p (list '&rest (cdr p)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
411 (let ((p (memq '&body args))) (if p (setcar p '&rest)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
412 (if (memq '&environment args) (error "&environment used incorrectly"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
413 (let ((save-args args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
414 (restarg (memq '&rest args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
415 (safety (if (cl-compiling-file) cl-optimize-safety 3))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
416 (keys nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
417 (laterarg nil) (exactarg nil) minarg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
418 (or num (setq num 0))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
419 (if (listp (cadr restarg))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
420 (setq restarg (gensym "--rest--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
421 (setq restarg (cadr restarg)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
422 (push (list restarg expr) bind-lets)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
423 (if (eq (car args) '&whole)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
424 (push (list (cl-pop2 args) restarg) bind-lets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
425 (let ((p args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
426 (setq minarg restarg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
427 (while (and p (not (memq (car p) lambda-list-keywords)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
428 (or (eq p args) (setq minarg (list 'cdr minarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
429 (setq p (cdr p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
430 (if (memq (car p) '(nil &aux))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
431 (setq minarg (list '= (list 'length restarg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
432 (length (ldiff args p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
433 exactarg (not (eq args p)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
434 (while (and args (not (memq (car args) lambda-list-keywords)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
435 (let ((poparg (list (if (or (cdr args) (not exactarg)) 'pop 'car)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
436 restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
437 (cl-do-arglist
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
438 (pop args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
439 (if (or laterarg (= safety 0)) poparg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
440 (list 'if minarg poparg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
441 (list 'signal '(quote wrong-number-of-arguments)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
442 (list 'list (and (not (eq bind-block 'cl-none))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
443 (list 'quote bind-block))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
444 (list 'length restarg)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
445 (setq num (1+ num) laterarg t))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
446 (while (and (eq (car args) '&optional) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
447 (while (and args (not (memq (car args) lambda-list-keywords)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
448 (let ((arg (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
449 (or (consp arg) (setq arg (list arg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
450 (if (cddr arg) (cl-do-arglist (nth 2 arg) (list 'and restarg t)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
451 (let ((def (if (cdr arg) (nth 1 arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
452 (or (car bind-defs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
453 (nth 1 (assq (car arg) bind-defs)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
454 (poparg (list 'pop restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
455 (and def bind-enquote (setq def (list 'quote def)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
456 (cl-do-arglist (car arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
457 (if def (list 'if restarg poparg def) poparg))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
458 (setq num (1+ num))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
459 (if (eq (car args) '&rest)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
460 (let ((arg (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
461 (if (consp arg) (cl-do-arglist arg restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
462 (or (eq (car args) '&key) (= safety 0) exactarg
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
463 (push (list 'if restarg
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
464 (list 'signal '(quote wrong-number-of-arguments)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
465 (list 'list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
466 (and (not (eq bind-block 'cl-none))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
467 (list 'quote bind-block))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
468 (list '+ num (list 'length restarg)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
469 bind-forms)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
470 (while (and (eq (car args) '&key) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
471 (while (and args (not (memq (car args) lambda-list-keywords)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
472 (let ((arg (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
473 (or (consp arg) (setq arg (list arg)))
4793
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
474 (let* ((karg (if (consp (car arg))
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
475 ;; It's possible to use non-keywords here, as
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
476 ;; in the KEYWORD-ARGUMENT-NAME-PACKAGE Common
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
477 ;; Lisp issue:
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
478 (caar arg)
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
479 ;; Use read instead of intern in case we ever
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
480 ;; actually get packages and keywords are no
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
481 ;; longer in obarray:
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
482 (read (concat ":" (symbol-name (car arg))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
483 (varg (if (consp (car arg)) (cadar arg) (car arg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
484 (def (if (cdr arg) (cadr arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
485 (or (car bind-defs) (cadr (assq varg bind-defs)))))
4793
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
486 (look (list 'memq (quote-maybe karg) restarg)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
487 (and def bind-enquote (setq def (list 'quote def)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
488 (if (cddr arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
489 (let* ((temp (or (nth 2 arg) (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
490 (val (list 'car (list 'cdr temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
491 (cl-do-arglist temp look)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
492 (cl-do-arglist varg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
493 (list 'if temp
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
494 (list 'prog1 val (list 'setq temp t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
495 def)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
496 (cl-do-arglist
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
497 varg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
498 (list 'car
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
499 (list 'cdr
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
500 (if (null def)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
501 look
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
502 (list 'or look
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
503 (if (eq (cl-const-expr-p def) t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
504 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
505 'quote
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
506 (list nil (cl-const-expr-val def)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
507 (list 'list nil def))))))))
4793
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
508 (push karg keys)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
509 (setq keys (nreverse keys))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
510 (or (and (eq (car args) '&allow-other-keys) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
511 (null keys) (= safety 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
512 (let* ((var (gensym "--keys--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
513 (allow '(:allow-other-keys))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
514 (check (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
515 'while var
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
516 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
517 'cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
518 (list (list 'memq (list 'car var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
519 (list 'quote (append keys allow)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
520 (list 'setq var (list 'cdr (list 'cdr var))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
521 (list (list 'car
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
522 (list 'cdr
4793
8b50bee3c88c Remove attempted support for 1996-era emacs without self-quoting keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
523 (list 'memq (car allow)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
524 restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
525 (list 'setq var nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
526 (list t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
527 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
528 'error
5084
6afe991b8135 Add a PARSE_KEYWORDS macro, use it in #'make-hash-table.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5080
diff changeset
529 ''invalid-keyword-argument
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
530 (list 'car var)))))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
531 (push (list 'let (list (list var restarg)) check) bind-forms)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
532 (while (and (eq (car args) '&aux) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
533 (while (and args (not (memq (car args) lambda-list-keywords)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
534 (if (consp (car args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
535 (if (and bind-enquote (cadar args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
536 (cl-do-arglist (caar args)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
537 (list 'quote (cadr (pop args))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
538 (cl-do-arglist (caar args) (cadr (pop args))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
539 (cl-do-arglist (pop args) nil))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
540 (if args (error "Malformed argument list %s" save-args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
541
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
542 (defun cl-arglist-args (args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
543 (if (nlistp args) (list args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
544 (let ((res nil) (kind nil) arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
545 (while (consp args)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
546 (setq arg (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
547 (if (memq arg lambda-list-keywords) (setq kind arg)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
548 (if (eq arg '&cl-defs) (pop args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
549 (and (consp arg) kind (setq arg (car arg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
550 (and (consp arg) (cdr arg) (eq kind '&key) (setq arg (cadr arg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
551 (setq res (nconc res (cl-arglist-args arg))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
552 (nconc res (and args (list args))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
553
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
554 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
555 (defmacro destructuring-bind (args expr &rest body)
872
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
556 "Bind the arguments in ARGS to EXPR then eval BODY.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
557 This is similar to `let' but it does \"destructuring\", in that it matches
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
558 the structure of ARGS to the structure of EXPR and binds corresponding
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
559 arguments in ARGS to their values in EXPR. The format of ARGS, and the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
560 way the destructuring works, is exactly like the destructuring that occurs
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
561 in `defmacro*'; see that for more information.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
562
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
563 An alternative means of destructuring is using the `loop' macro. `loop'
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
564 gives practical examples of destructuring. `defmacro*' describes the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
565 differences between loop and macro-style destructuring.
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
566
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
567 You can rewrite a call to (destructuring-bind ARGS EXPR &rest BODY) using
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
568 `loop', approximately like this:
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
569
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
570 (loop for ARGS = EXPR
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
571 return (progn BODY))
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
572
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
573 I say \"approximately\" because the destructuring works in a somewhat
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
574 different fashion, although for most reasonably simple constructs the
79c6ff3eef26 [xemacs-hg @ 2002-06-20 21:18:01 by ben]
ben
parents: 800
diff changeset
575 results will be the same."
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
576 (let* ((bind-lets nil) (bind-forms nil) (bind-inits nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
577 (bind-defs nil) (bind-block 'cl-none))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
578 (cl-do-arglist (or args '(&aux)) expr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
579 (append '(progn) bind-inits
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
580 (list (nconc (list 'let* (nreverse bind-lets))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
581 (nreverse bind-forms) body)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
582
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
583
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
584 ;;; The `eval-when' form.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
585
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
586 (defvar cl-not-toplevel nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
587
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
588 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
589 (defmacro eval-when (when &rest body)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
590 "Control when BODY is evaluated.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
591 If `compile' is in WHEN, BODY is evaluated when compiled at top-level.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
592 If `load' is in WHEN, BODY is evaluated when loaded after top-level compile.
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
593 If `eval' is in WHEN, BODY is evaluated when interpreted or at non-top-level.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
594
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
595 arguments: ((&rest WHEN) &body BODY)"
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
596 (if (and (fboundp 'cl-compiling-file) (cl-compiling-file)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
597 (not cl-not-toplevel) (not (boundp 'for-effect))) ; horrible kludge
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
598 (let ((comp (or (memq 'compile when) (memq :compile-toplevel when)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
599 (cl-not-toplevel t))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
600 (if (or (memq 'load when) (memq :load-toplevel when))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
601 (if comp (cons 'progn (mapcar 'cl-compile-time-too body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
602 (list* 'if nil nil body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
603 (progn (if comp (eval (cons 'progn body))) nil)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
604 (and (or (memq 'eval when) (memq :execute when))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
605 (cons 'progn body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
606
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
607 (defun cl-compile-time-too (form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
608 (or (and (symbolp (car-safe form)) (get (car-safe form) 'byte-hunk-handler))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
609 (setq form (macroexpand
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
610 form (cons '(eval-when) byte-compile-macro-environment))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
611 (cond ((eq (car-safe form) 'progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
612 (cons 'progn (mapcar 'cl-compile-time-too (cdr form))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
613 ((eq (car-safe form) 'eval-when)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
614 (let ((when (nth 1 form)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
615 (if (or (memq 'eval when) (memq :execute when))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
616 (list* 'eval-when (cons 'compile when) (cddr form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
617 form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
618 (t (eval form) form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
619
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
620 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
621 (defmacro load-time-value (form &optional read-only)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
622 "Like `progn', but evaluates the body at load time.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
623 The result of the body appears to the compiler as a quoted constant."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
624 (if (cl-compiling-file)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
625 (let* ((temp (gentemp "--cl-load-time--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
626 (set (list 'set (list 'quote temp) form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
627 (if (and (fboundp 'byte-compile-file-form-defmumble)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
628 (boundp 'this-kind) (boundp 'that-one))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
629 (fset 'byte-compile-file-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
630 (list 'lambda '(form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
631 (list 'fset '(quote byte-compile-file-form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
632 (list 'quote
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
633 (symbol-function 'byte-compile-file-form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
634 (list 'byte-compile-file-form (list 'quote set))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
635 '(byte-compile-file-form form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
636 ;; XEmacs change
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
637 (print set (symbol-value ;;'outbuffer
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
638 'byte-compile-output-buffer
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
639 )))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
640 (list 'symbol-value (list 'quote temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
641 (list 'quote (eval form))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
642
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
643
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
644 ;;; Conditional control structures.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
645
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
646 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
647 (defmacro case (expr &rest clauses)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
648 "Evals EXPR, chooses from CLAUSES on that value.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
649 Each clause looks like (KEYLIST BODY...). EXPR is evaluated and compared
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
650 against each key in each KEYLIST; the corresponding BODY is evaluated.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
651 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
652 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
653 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
654 Key values are compared by `eql'."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
655 (let* ((temp (if (cl-simple-expr-p expr 3) expr (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
656 (head-list nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
657 (last-clause (car (last clauses)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
658 (body (cons
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
659 'cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
660 (mapcar
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
661 #'(lambda (c)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
662 (cons (cond ((memq (car c) '(t otherwise))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
663 ;; XEmacs addition: check for last clause
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
664 (or (eq c last-clause)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
665 (error
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
666 "`%s' is allowed only as the last case clause"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
667 (car c)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
668 t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
669 ((eq (car c) 'ecase-error-flag)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
670 (list 'error "ecase failed: %s, %s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
671 temp (list 'quote (reverse head-list))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
672 ((listp (car c))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
673 (setq head-list (append (car c) head-list))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
674 (list 'member* temp (list 'quote (car c))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
675 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
676 (if (memq (car c) head-list)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
677 (error "Duplicate key in case: %s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
678 (car c)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
679 (push (car c) head-list)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
680 (list 'eql temp (list 'quote (car c)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
681 (or (cdr c) '(nil))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
682 clauses))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
683 (if (eq temp expr) body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
684 (list 'let (list (list temp expr)) body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
685
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
686 ;; #### CL standard also requires `ccase', which signals a continuable
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
687 ;; error (`cerror' in XEmacs). However, I don't think it buys us
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
688 ;; anything to introduce it, as there is probably much more CL stuff
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
689 ;; missing, and the feature is not essential. --hniksic
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
690
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
691 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
692 (defmacro ecase (expr &rest clauses)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
693 "Like `case', but error if no case fits.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
694 `otherwise'-clauses are not allowed."
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
695 ;; XEmacs addition: disallow t and otherwise
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
696 (let ((disallowed (or (assq t clauses)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
697 (assq 'otherwise clauses))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
698 (if disallowed
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
699 (error "`%s' is not allowed in ecase" (car disallowed))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
700 (list* 'case expr (append clauses '((ecase-error-flag)))))
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 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
703 (defmacro typecase (expr &rest clauses)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
704 "Evals EXPR, chooses from CLAUSES on that value.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
705 Each clause looks like (TYPE BODY...). EXPR is evaluated and, if it
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
706 satisfies TYPE, the corresponding BODY is evaluated. If no clause succeeds,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
707 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
708 final clause, and matches if no other keys match."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
709 (let* ((temp (if (cl-simple-expr-p expr 3) expr (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
710 (type-list nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
711 (body (cons
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
712 'cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
713 (mapcar
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
714 #'(lambda (c)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
715 (cons (cond ((eq (car c) 'otherwise) t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
716 ((eq (car c) 'ecase-error-flag)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
717 (list 'error "etypecase failed: %s, %s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
718 temp (list 'quote (reverse type-list))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
719 (t
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
720 (push (car c) type-list)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
721 (cl-make-type-test temp (car c))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
722 (or (cdr c) '(nil))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
723 clauses))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
724 (if (eq temp expr) body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
725 (list 'let (list (list temp expr)) body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
726
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
727 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
728 (defmacro etypecase (expr &rest clauses)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
729 "Like `typecase', but error if no case fits.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
730 `otherwise'-clauses are not allowed."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
731 (list* 'typecase expr (append clauses '((ecase-error-flag)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
732
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
733
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
734 ;;; Blocks and exits.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
735
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
736 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
737 (defmacro block (name &rest body)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
738 "Define a lexically-scoped block named NAME.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
739 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
740 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
741 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
742 quoted symbol or other form; and second, NAME is lexically rather than
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
743 dynamically scoped: Only references to it within BODY will work. These
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
744 references may appear inside macro expansions, but not inside functions
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
745 called from BODY."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
746 (if (cl-safe-expr-p (cons 'progn body)) (cons 'progn body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
747 (list 'cl-block-wrapper
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
748 (list* 'catch (list 'quote (intern (format "--cl-block-%s--" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
749 body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
750
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
751 (defvar cl-active-block-names nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
752
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
753 (put 'cl-block-wrapper 'byte-compile
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
754 #'(lambda (cl-form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
755 (if (/= (length cl-form) 2)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
756 (byte-compile-warn-wrong-args cl-form 1))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
757
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
758 (if (fboundp 'byte-compile-form-do-effect) ; Check for optimizing
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
759 ; compiler
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
760 (progn
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
761 (let* ((cl-entry (cons (nth 1 (nth 1 (nth 1 cl-form))) nil))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
762 (cl-active-block-names (cons cl-entry
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
763 cl-active-block-names))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
764 (cl-body (byte-compile-top-level
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
765 (cons 'progn (cddr (nth 1 cl-form))))))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
766 (if (cdr cl-entry)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
767 (byte-compile-form (list 'catch (nth 1 (nth 1 cl-form))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
768 cl-body))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
769 (byte-compile-form cl-body))))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
770 (byte-compile-form (nth 1 cl-form)))))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
771
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
772 (put 'cl-block-throw 'byte-compile
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
773 #'(lambda (cl-form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
774 (let ((cl-found (assq (nth 1 (nth 1 cl-form)) cl-active-block-names)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
775 (if cl-found (setcdr cl-found t)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
776 (byte-compile-throw (cons 'throw (cdr cl-form)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
777
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
778 ;;;###autoload
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
779 (defmacro return (&optional result)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
780 "Return from the block named nil.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
781 This is equivalent to `(return-from nil RESULT)'."
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
782 (list 'return-from nil result))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
783
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
784 ;;;###autoload
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
785 (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
786 "Return from the block named NAME.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
787 This jumps out to the innermost enclosing `(block NAME ...)' form,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
788 returning RESULT from that form (or nil if RESULT is omitted).
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
789 This is compatible with Common Lisp, but note that `defun' and
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
790 `defmacro' do not create implicit blocks as they do in Common Lisp."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
791 (let ((name2 (intern (format "--cl-block-%s--" name))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
792 (list 'cl-block-throw (list 'quote name2) result)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
793
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
794
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
795 ;;; The "loop" macro.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
796
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
797 (defvar args) (defvar loop-accum-var) (defvar loop-accum-vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
798 (defvar loop-bindings) (defvar loop-body) (defvar loop-destr-temps)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
799 (defvar loop-finally) (defvar loop-finish-flag) (defvar loop-first-flag)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
800 (defvar loop-initially) (defvar loop-map-form) (defvar loop-name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
801 (defvar loop-result) (defvar loop-result-explicit)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
802 (defvar loop-result-var) (defvar loop-steps) (defvar loop-symbol-macs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
803
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
804 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
805 (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
806 "The Common Lisp `loop' macro.
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
807
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
808 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
809 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
810 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
811 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
812 body repeatedly until an exit condition is hit.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
813
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
814 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
815 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
816 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
817 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
818 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
819 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
820 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
821 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
822 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
823 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
824 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
825
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
826 \(loop
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
827 for x in list
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
828 while x
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
829 do ...)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
830
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
831 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
832 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
833 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
834
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
835 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
836 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
837 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
838 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
839 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
840 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
841 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
842 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
843 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
844 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
845 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
846 `return-from'.)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
847
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
848 Another extremely useful feature of loops is called \"destructuring\". If,
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
849 in place of VAR, a list (possibly dotted, possibly a tree of arbitary
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
850 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
851 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
852 with corresponding elements in the structure. For example:
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
853
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
854 \(loop
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
855 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
856 do (puthash x y some-hash-table))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
857
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
858 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
859 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
860
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
861 \(loop for (x . y) in alist do ...)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
862
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
863 and plists using
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 \(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
866
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
867 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
868 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
869 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
870 most useful feature of `loop'.
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
871
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
872 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
873
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
874 \(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
875 collect (cons x y))
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
876
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
877 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
878 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
879 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
880
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
881 An example of in-place modification is
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
882
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
883 \(setq foo '(1 3 5))
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
884 \(loop for x in-ref foo do
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
885 (setf x (* x x)))
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
886
37bdd24225ef [xemacs-hg @ 2002-11-27 07:15:02 by ben]
ben
parents: 872
diff changeset
887 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
888
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
889 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
890 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
891
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
892 Valid clauses are:
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
893
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
894 \(NOTE: Keywords in lowercase\; slashes separate different possibilities
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
895 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
896 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
897 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
898 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
899 either `being each foo' or `being the foos'.)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
900
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
901 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
902 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
903 indicate upward stepping\; `downfrom', `downto', and `above' explicitly
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
904 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
905 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
906 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
907 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
908
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
909 for VAR in LIST [by FUNC]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
910 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
911 sublists and defaults to `cdr'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
912
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
913 for VAR on LIST [by FUNC]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
914 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
915 sublists and defaults to `cdr'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
916
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
917 for VAR in-ref LIST [by FUNC]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
918 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
919 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
920 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
921 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
922 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
923 subsequent uses of VAR.
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 = INIT [then EXPR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
926 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
927 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
928 on subsequent ones.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
929
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
930 for VAR across/across-ref ARRAY
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
931 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
932 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
933 `symbol-macrolet' instead of `let' -- see above.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
934
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
935 for VAR being each/the 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
936 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
937 `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
938 `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
939 `let' -- see above.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
940
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
941 for VAR being each/the 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
942
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
943 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
944 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
945 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
946 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
947
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
948 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
949 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
950 currently synonymous.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
951
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
952 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
953 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
954 current buffer, the beginning and the end, respectively.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
955
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
956 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
957 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
958 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
959 respectively. If PROPERTY is given, iteration occurs using
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
960 `next-single-property-change'\; otherwise, using
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
961 `next-property-change'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
962
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
963 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
964 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
965
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
966 for VAR being each/the frame/frames
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
967 Step VAR over all frames.
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 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
970 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
971 `for VAR in (buffer-list) [by FUNC]'.
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 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
974 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
975 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
976 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
977 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
978 (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
979 (third argument of `define-key').
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
980
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
981 as VAR ...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
982 `as' is a synonym for `for'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
983
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
984 and VAR ...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
985 `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
986 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
987 `and'/`for' clause instead of in series.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
988
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
989 with VAR = INIT
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
990 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
991
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
992 repeat NUM
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
993 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
994
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
995 while COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
996 Exit the loop if COND isn't true.
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 until COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
999 Exit the loop if COND is true.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1000
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1001 collect EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1002 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
1003 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
1004 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
1005 `loop-finish'.
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 append EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1008 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
1009
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1010 nconc EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1011 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
1012
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1013 concat EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1014 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
1015 `collect'.
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 vconcat EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1018 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
1019 `collect'.
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 bvconcat EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1022 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
1023 like `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1024
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1025 sum EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1026 Add EXPR to a value, like `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1027
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1028 count EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1029 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
1030
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1031 maximize EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1032 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
1033 `collect'.
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 minimize EXPR [into VAR]
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1036 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
1037 `collect'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1038
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1039 always COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1040 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
1041 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
1042 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
1043 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
1044 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
1045
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1046 never COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1047 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
1048 `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
1049 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
1050 iterations of the loop).
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1051
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1052 thereis COND
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1053 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
1054
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1055 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
1056 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
1057 execute the clauses following `else'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1058
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1059 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
1060 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
1061
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1062 do EXPRS...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1063 Execute the expressions (any Lisp forms).
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1064
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1065 initially EXPRS...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1066 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
1067 been set using `with'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1068
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1069 finally EXPRS...
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1070 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
1071 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
1072 `never', `thereis', or `return'.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1073
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1074 return EXPR
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1075 Exit from the loop and return EXPR.
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1076
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1077 finally return EXPR
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1078 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
1079 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
1080 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
1081 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
1082
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1083 named NAME
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1084 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
1085 (See `block'.)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1086 "
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1087 (if (not (memq t (mapcar 'symbolp (delq nil (delq t (copy-list clauses))))))
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1088 (list 'block nil (list* 'while t clauses))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1089 (let ((loop-name nil) (loop-bindings nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1090 (loop-body nil) (loop-steps nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1091 (loop-result nil) (loop-result-explicit nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1092 (loop-result-var nil) (loop-finish-flag nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1093 (loop-accum-var nil) (loop-accum-vars nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1094 (loop-initially nil) (loop-finally nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1095 (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
1096 (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
1097 (args (append clauses '(cl-end-loop))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1098 (while (not (eq (car args) 'cl-end-loop)) (cl-parse-loop-clause))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1099 (if loop-finish-flag
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1100 (push (list (list loop-finish-flag t)) loop-bindings))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1101 (if loop-first-flag
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1102 (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
1103 (push (list 'setq loop-first-flag nil) loop-steps)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1104 (let* ((epilogue (nconc (nreverse loop-finally)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1105 (list (or loop-result-explicit loop-result))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1106 (ands (cl-loop-build-ands (nreverse loop-body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1107 (while-body (nconc (cadr ands) (nreverse loop-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1108 (body (append
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1109 (nreverse loop-initially)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1110 (list (if loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1111 (list 'block '--cl-finish--
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1112 (subst
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1113 (if (eq (car ands) t) while-body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1114 (cons (list 'or (car ands)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1115 '(return-from --cl-finish--
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1116 nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1117 while-body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1118 '--cl-map loop-map-form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1119 (list* 'while (car ands) while-body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1120 (if loop-finish-flag
1346
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1121 (if (equal epilogue '(nil))
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1122 ;; XEmacs change: When epilogue is nil and
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1123 ;; 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
1124 ;; warning using the original (commented-out)
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1125 ;; 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
1126 ;; 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
1127 ;; --ben
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1128 ;(list loop-result-var)
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1129 (list (list 'if loop-finish-flag
01c57eb70ae9 [xemacs-hg @ 2003-03-09 02:27:27 by ben]
ben
parents: 1123
diff changeset
1130 loop-result-var loop-result-var))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1131 (list (list 'if loop-finish-flag
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1132 (cons 'progn epilogue) loop-result-var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1133 epilogue))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1134 (if loop-result-var (push (list loop-result-var) loop-bindings))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1135 (while loop-bindings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1136 (if (cdar loop-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1137 (setq body (list (cl-loop-let (pop loop-bindings) body t)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1138 (let ((lets nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1139 (while (and loop-bindings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1140 (not (cdar loop-bindings)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1141 (push (car (pop loop-bindings)) lets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1142 (setq body (list (cl-loop-let lets body nil))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1143 (if loop-symbol-macs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1144 (setq body (list (list* 'symbol-macrolet loop-symbol-macs body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1145 (list* 'block loop-name body)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1146
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1147 (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
1148 (let ((word (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1149 (hash-types '(hash-key hash-keys hash-value hash-values))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1150 (key-types '(key-code key-codes key-seq key-seqs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1151 key-binding key-bindings)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1152 (cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1153
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1154 ((null args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1155 (error "Malformed `loop' macro"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1156
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1157 ((eq word 'named)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1158 (setq loop-name (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1159
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1160 ((eq word 'initially)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1161 (if (memq (car args) '(do doing)) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1162 (or (consp (car args)) (error "Syntax error on `initially' clause"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1163 (while (consp (car args))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1164 (push (pop args) loop-initially)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1165
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1166 ((eq word 'finally)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1167 (if (eq (car args) 'return)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1168 (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
1169 (if (memq (car args) '(do doing)) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1170 (or (consp (car args)) (error "Syntax error on `finally' clause"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1171 (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
1172 (setq loop-result-explicit (or (nth 1 (pop args)) '(quote nil)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1173 (while (consp (car args))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1174 (push (pop args) loop-finally)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1175
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1176 ((memq word '(for as))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1177 (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
1178 (ands nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1179 (while
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1180 (let ((var (or (pop args) (gensym))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1181 (setq word (pop args))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1182 (if (eq word 'being) (setq word (pop args)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1183 (if (memq word '(the each)) (setq word (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1184 (if (memq word '(buffer buffers))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1185 (setq word 'in args (cons '(buffer-list) args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1186 (cond
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1187
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1188 ((memq word '(from downfrom upfrom to downto upto
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1189 above below by))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1190 (push word args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1191 (if (memq (car args) '(downto above))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1192 (error "Must specify `from' value for downward loop"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1193 (let* ((down (or (eq (car args) 'downfrom)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1194 (memq (caddr args) '(downto above))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1195 (excl (or (memq (car args) '(above below))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1196 (memq (caddr args) '(above below))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1197 (start (and (memq (car args) '(from upfrom downfrom))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1198 (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1199 (end (and (memq (car args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1200 '(to upto downto above below))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1201 (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1202 (step (and (eq (car args) 'by) (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1203 (end-var (and (not (cl-const-expr-p end)) (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1204 (step-var (and (not (cl-const-expr-p step))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1205 (gensym))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1206 (and step (numberp step) (<= step 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1207 (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
1208 (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
1209 (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
1210 (if step-var (push (list step-var step)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1211 loop-for-bindings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1212 (if end
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1213 (push (list
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1214 (if down (if excl '> '>=) (if excl '< '<=))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1215 var (or end-var end)) loop-body))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1216 (push (list var (list (if down '- '+) var
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1217 (or step-var step 1)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1218 loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1219
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1220 ((memq word '(in in-ref on))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1221 (let* ((on (eq word 'on))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1222 (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
1223 (push (list temp (pop args)) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1224 (push (list 'consp temp) loop-body)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1225 (if (eq word 'in-ref)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1226 (push (list var (list 'car temp)) loop-symbol-macs)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1227 (or (eq temp var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1228 (progn
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1229 (push (list var nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1230 (push (list var (if on temp (list 'car temp)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1231 loop-for-sets))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1232 (push (list temp
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1233 (if (eq (car args) 'by)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1234 (let ((step (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1235 (if (and (memq (car-safe step)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1236 '(quote function
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1237 function*))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1238 (symbolp (nth 1 step)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1239 (list (nth 1 step) temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1240 (list 'funcall step temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1241 (list 'cdr temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1242 loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1243
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1244 ((eq word '=)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1245 (let* ((start (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1246 (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
1247 (push (list var nil) loop-for-bindings)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1248 (if (or ands (eq (car args) 'and))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1249 (progn
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1250 (push (list var
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1251 (list 'if
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1252 (or loop-first-flag
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1253 (setq loop-first-flag
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1254 (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1255 start var))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1256 loop-for-sets)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1257 (push (list var then) loop-for-steps))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1258 (push (list var
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1259 (if (eq start then) start
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1260 (list 'if
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1261 (or loop-first-flag
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1262 (setq loop-first-flag (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1263 start then)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1264 loop-for-sets))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1265
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1266 ((memq word '(across across-ref))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1267 (let ((temp-vec (gensym)) (temp-idx (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1268 (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
1269 (push (list temp-idx -1) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1270 (push (list '< (list 'setq temp-idx (list '1+ temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1271 (list 'length temp-vec)) loop-body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1272 (if (eq word 'across-ref)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1273 (push (list var (list 'aref temp-vec temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1274 loop-symbol-macs)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1275 (push (list var nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1276 (push (list var (list 'aref temp-vec temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1277 loop-for-sets))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1278
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1279 ((memq word '(element elements))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1280 (let ((ref (or (memq (car args) '(in-ref of-ref))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1281 (and (not (memq (car args) '(in of)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1282 (error "Expected `of'"))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1283 (seq (cl-pop2 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1284 (temp-seq (gensym))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1285 (temp-idx (if (eq (car args) 'using)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1286 (if (and (= (length (cadr args)) 2)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1287 (eq (caadr args) 'index))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1288 (cadr (cl-pop2 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1289 (error "Bad `using' clause"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1290 (gensym))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1291 (push (list temp-seq seq) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1292 (push (list temp-idx 0) loop-for-bindings)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1293 (if ref
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1294 (let ((temp-len (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1295 (push (list temp-len (list 'length temp-seq))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1296 loop-for-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1297 (push (list var (list 'elt temp-seq temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1298 loop-symbol-macs)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1299 (push (list '< temp-idx temp-len) loop-body))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1300 (push (list var nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1301 (push (list 'and temp-seq
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1302 (list 'or (list 'consp temp-seq)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1303 (list '< temp-idx
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1304 (list 'length temp-seq))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1305 loop-body)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1306 (push (list var (list 'if (list 'consp temp-seq)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1307 (list 'pop temp-seq)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1308 (list 'aref temp-seq temp-idx)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1309 loop-for-sets))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1310 (push (list temp-idx (list '1+ temp-idx))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1311 loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1312
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1313 ((memq word hash-types)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1314 (or (memq (car args) '(in of)) (error "Expected `of'"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1315 (let* ((table (cl-pop2 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1316 (other (if (eq (car args) 'using)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1317 (if (and (= (length (cadr args)) 2)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1318 (memq (caadr args) hash-types)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1319 (not (eq (caadr args) word)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1320 (cadr (cl-pop2 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1321 (error "Bad `using' clause"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1322 (gensym))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1323 (if (memq word '(hash-value hash-values))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1324 (setq var (prog1 other (setq other var))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1325 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1326 (list 'maphash (list 'function
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1327 (list* 'lambda (list var other)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1328 '--cl-map)) table))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1329
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1330 ((memq word '(symbol present-symbol external-symbol
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1331 symbols present-symbols external-symbols))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1332 (let ((ob (and (memq (car args) '(in of)) (cl-pop2 args))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1333 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1334 (list 'mapatoms (list 'function
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1335 (list* 'lambda (list var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1336 '--cl-map)) ob))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1337
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1338 ((memq word '(overlay overlays extent extents))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1339 (let ((buf nil) (from nil) (to nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1340 (while (memq (car args) '(in of from to))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1341 (cond ((eq (car args) 'from) (setq from (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1342 ((eq (car args) 'to) (setq to (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1343 (t (setq buf (cl-pop2 args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1344 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1345 (list 'cl-map-extents
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1346 (list 'function (list 'lambda (list var (gensym))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1347 '(progn . --cl-map) nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1348 buf from to))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1349
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1350 ((memq word '(interval intervals))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1351 (let ((buf nil) (prop nil) (from nil) (to nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1352 (var1 (gensym)) (var2 (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1353 (while (memq (car args) '(in of property from to))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1354 (cond ((eq (car args) 'from) (setq from (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1355 ((eq (car args) 'to) (setq to (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1356 ((eq (car args) 'property)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1357 (setq prop (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1358 (t (setq buf (cl-pop2 args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1359 (if (and (consp var) (symbolp (car var)) (symbolp (cdr var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1360 (setq var1 (car var) var2 (cdr var))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1361 (push (list var (list 'cons var1 var2)) loop-for-sets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1362 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1363 (list 'cl-map-intervals
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1364 (list 'function (list 'lambda (list var1 var2)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1365 '(progn . --cl-map)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1366 buf prop from to))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1367
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1368 ((memq word key-types)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1369 (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
1370 (let* ((map (cl-pop2 args))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1371 other-word
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1372 (other (if (eq (car args) 'using)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1373 (if (and (= (length (cadr args)) 2)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1374 (memq (setq other-word (caadr args))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1375 key-types)
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1376 (not (eq (caadr args) word)))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1377 (cadr (cl-pop2 args))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1378 (error "Bad `using' clause"))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1379 (gensym))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1380 ;; XEmacs addition: track other-word
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1381 (when (memq word '(key-binding key-bindings))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1382 (setq var (prog1 other (setq other var)))
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1383 (and other-word (setq word other-word)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1384 (setq loop-map-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1385 (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
1386 'cl-map-keymap-recursively 'map-keymap)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1387 (list 'function (list* 'lambda (list var other)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1388 '--cl-map)) map))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1389
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1390 ((memq word '(frame frames screen screens))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1391 (let ((temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1392 (push (list var '(selected-frame))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1393 loop-for-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1394 (push (list temp nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1395 (push (list 'prog1 (list 'not (list 'eq var temp))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1396 (list 'or temp (list 'setq temp var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1397 loop-body)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1398 (push (list var (list 'next-frame var))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1399 loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1400
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1401 ((memq word '(window windows))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1402 (let ((scr (and (memq (car args) '(in of)) (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1403 (temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1404 (push (list var (if scr
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1405 (list 'frame-selected-window scr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1406 '(selected-window)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1407 loop-for-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1408 (push (list temp nil) loop-for-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1409 (push (list 'prog1 (list 'not (list 'eq var temp))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1410 (list 'or temp (list 'setq temp var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1411 loop-body)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1412 (push (list var (list 'next-window var)) loop-for-steps)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1413
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1414 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1415 (let ((handler (and (symbolp word)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1416 (get word 'cl-loop-for-handler))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1417 (if handler
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1418 (funcall handler var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1419 (error "Expected a `for' preposition, found %s" word)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1420 (eq (car args) 'and))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1421 (setq ands t)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1422 (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1423 (if (and ands loop-for-bindings)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1424 (push (nreverse loop-for-bindings) loop-bindings)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1425 (setq loop-bindings (nconc (mapcar 'list loop-for-bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1426 loop-bindings)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1427 (if loop-for-sets
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1428 (push (list 'progn
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1429 (cl-loop-let (nreverse loop-for-sets) 'setq ands)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1430 t) loop-body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1431 (if loop-for-steps
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1432 (push (cons (if ands 'psetq 'setq)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1433 (apply 'append (nreverse loop-for-steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1434 loop-steps))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1435
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1436 ((eq word 'repeat)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1437 (let ((temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1438 (push (list (list temp (pop args))) loop-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1439 (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
1440
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1441 ((memq word '(collect collecting))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1442 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1443 (var (cl-loop-handle-accum nil 'nreverse)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1444 (if (eq var loop-accum-var)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1445 (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
1446 (push (list 'progn
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1447 (list 'setq var (list 'nconc var (list 'list what)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1448 t) loop-body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1449
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1450 ((memq word '(nconc nconcing append appending))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1451 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1452 (var (cl-loop-handle-accum nil 'nreverse)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1453 (push (list 'progn
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1454 (list 'setq var
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1455 (if (eq var loop-accum-var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1456 (list 'nconc
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1457 (list (if (memq word '(nconc nconcing))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1458 'nreverse 'reverse)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1459 what)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1460 var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1461 (list (if (memq word '(nconc nconcing))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1462 'nconc 'append)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1463 var what))) t) loop-body)))
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 ((memq word '(concat concating))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1466 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1467 (var (cl-loop-handle-accum "")))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1468 (push (list 'progn (list 'callf 'concat var what) t) loop-body)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1469
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1470 ((memq word '(vconcat vconcating))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1471 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1472 (var (cl-loop-handle-accum [])))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1473 (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
1474
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1475 ;; XEmacs addition: handle bit-vectors
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1476 ((memq word '(bvconcat bvconcating))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1477 (let ((what (pop args))
800
a5954632b187 [xemacs-hg @ 2002-03-31 08:27:14 by ben]
ben
parents: 613
diff changeset
1478 (var (cl-loop-handle-accum #*)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1479 (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
1480
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1481 ((memq word '(sum summing))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1482 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1483 (var (cl-loop-handle-accum 0)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1484 (push (list 'progn (list 'incf var what) t) loop-body)))
428
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 '(count counting))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1487 (let ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1488 (var (cl-loop-handle-accum 0)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1489 (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
1490
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1491 ((memq word '(minimize minimizing maximize maximizing))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1492 (let* ((what (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1493 (temp (if (cl-simple-expr-p what) what (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1494 (var (cl-loop-handle-accum nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1495 (func (intern (substring (symbol-name word) 0 3)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1496 (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
1497 (push (list 'progn (if (eq temp what) set
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1498 (list 'let (list (list temp what)) set))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1499 t) loop-body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1500
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1501 ((eq word 'with)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1502 (let ((bindings nil))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1503 (while (progn (push (list (pop args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1504 (and (eq (car args) '=) (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1505 bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1506 (eq (car args) 'and))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1507 (pop args))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1508 (push (nreverse bindings) loop-bindings)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1509
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1510 ((eq word 'while)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1511 (push (pop args) loop-body))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1512
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1513 ((eq word 'until)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1514 (push (list 'not (pop args)) loop-body))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1515
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1516 ((eq word 'always)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1517 (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
1518 (push (list 'setq loop-finish-flag (pop args)) loop-body)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1519 (setq loop-result t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1520
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1521 ((eq word 'never)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1522 (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
1523 (push (list 'setq loop-finish-flag (list 'not (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1524 loop-body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1525 (setq loop-result t))
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 ((eq word 'thereis)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1528 (or loop-finish-flag (setq loop-finish-flag (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1529 (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
1530 (push (list 'setq loop-finish-flag
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1531 (list 'not (list 'setq loop-result-var (pop args))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1532 loop-body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1533
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1534 ((memq word '(if when unless))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1535 (let* ((cond (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1536 (then (let ((loop-body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1537 (cl-parse-loop-clause)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1538 (cl-loop-build-ands (nreverse loop-body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1539 (else (let ((loop-body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1540 (if (eq (car args) 'else)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1541 (progn (pop args) (cl-parse-loop-clause)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1542 (cl-loop-build-ands (nreverse loop-body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1543 (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
1544 (if (eq (car args) 'end) (pop args))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1545 (if (eq word 'unless) (setq then (prog1 else (setq else then))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1546 (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
1547 (if simple (nth 1 else) (list (nth 2 else))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1548 (if (cl-expr-contains form 'it)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1549 (let ((temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1550 (push (list temp) loop-bindings)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1551 (setq form (list* 'if (list 'setq temp cond)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1552 (subst temp 'it form))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1553 (setq form (list* 'if cond form)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1554 (push (if simple (list 'progn form t) form) loop-body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1555
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1556 ((memq word '(do doing))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1557 (let ((body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1558 (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
1559 (while (consp (car args)) (push (pop args) body))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1560 (push (cons 'progn (nreverse (cons t body))) loop-body)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1561
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1562 ((eq word 'return)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1563 (or loop-finish-flag (setq loop-finish-flag (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1564 (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
1565 (push (list 'setq loop-result-var (pop args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1566 loop-finish-flag nil) loop-body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1567
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1568 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1569 (let ((handler (and (symbolp word) (get word 'cl-loop-handler))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1570 (or handler (error "Expected a loop keyword, found %s" word))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1571 (funcall handler))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1572 (if (eq (car args) 'and)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1573 (progn (pop args) (cl-parse-loop-clause)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1574
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1575 (defun cl-loop-let (specs body par) ; uses loop-*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1576 (let ((p specs) (temps nil) (new nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1577 (while (and p (or (symbolp (car-safe (car p))) (null (cadar p))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1578 (setq p (cdr p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1579 (and par p
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1580 (progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1581 (setq par nil p specs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1582 (while p
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1583 (or (cl-const-expr-p (cadar p))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1584 (let ((temp (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1585 (push (list temp (cadar p)) temps)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1586 (setcar (cdar p) temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1587 (setq p (cdr p)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1588 (while specs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1589 (if (and (consp (car specs)) (listp (caar specs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1590 (let* ((spec (caar specs)) (nspecs nil)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1591 (expr (cadr (pop specs)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1592 (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
1593 (car (push (cons spec (or (last spec 0)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1594 (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1595 loop-destr-temps))))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1596 (push (list temp expr) new)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1597 (while (consp spec)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1598 (push (list (pop spec)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1599 (and expr (list (if spec 'pop 'car) temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1600 nspecs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1601 (setq specs (nconc (nreverse nspecs) specs)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1602 (push (pop specs) new)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1603 (if (eq body 'setq)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1604 (let ((set (cons (if par 'psetq 'setq) (apply 'nconc (nreverse new)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1605 (if temps (list 'let* (nreverse temps) set) set))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1606 (list* (if par 'let 'let*)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1607 (nconc (nreverse temps) (nreverse new)) body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1608
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1609 (defun cl-loop-handle-accum (def &optional func) ; uses args, loop-*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1610 (if (eq (car args) 'into)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1611 (let ((var (cl-pop2 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1612 (or (memq var loop-accum-vars)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1613 (progn (push (list (list var def)) loop-bindings)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1614 (push var loop-accum-vars)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1615 var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1616 (or loop-accum-var
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1617 (progn
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1618 (push (list (list (setq loop-accum-var (gensym)) def))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1619 loop-bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1620 (setq loop-result (if func (list func loop-accum-var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1621 loop-accum-var))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1622 loop-accum-var))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1623
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1624 (defun cl-loop-build-ands (clauses)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1625 (let ((ands nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1626 (body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1627 (while clauses
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1628 (if (and (eq (car-safe (car clauses)) 'progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1629 (eq (car (last (car clauses))) t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1630 (if (cdr clauses)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1631 (setq clauses (cons (nconc (butlast (car clauses))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1632 (if (eq (car-safe (cadr clauses))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1633 'progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1634 (cdadr clauses)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1635 (list (cadr clauses))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1636 (cddr clauses)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1637 (setq body (cdr (butlast (pop clauses)))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1638 (push (pop clauses) ands)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1639 (setq ands (or (nreverse ands) (list t)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1640 (list (if (cdr ands) (cons 'and ands) (car ands))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1641 body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1642 (let ((full (if body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1643 (append ands (list (cons 'progn (append body '(t)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1644 ands)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1645 (if (cdr full) (cons 'and full) (car full))))))
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
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1648 ;;; Other iteration control structures.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1649
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1650 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1651 (defmacro do (steps endtest &rest body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1652 "The Common Lisp `do' loop.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1653 Format is: (do ((VAR INIT [STEP])...) (END-TEST [RESULT...]) BODY...)"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1654 (cl-expand-do-loop steps endtest body nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1655
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1656 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1657 (defmacro do* (steps endtest &rest body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1658 "The Common Lisp `do*' loop.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1659 Format is: (do* ((VAR INIT [STEP])...) (END-TEST [RESULT...]) BODY...)"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1660 (cl-expand-do-loop steps endtest body t))
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 (defun cl-expand-do-loop (steps endtest body star)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1663 (list 'block nil
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1664 (list* (if star 'let* 'let)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1665 (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
1666 steps)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1667 (list* 'while (list 'not (car endtest))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1668 (append body
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1669 (let ((sets (mapcar
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1670 #'(lambda (c)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1671 (and (consp c) (cdr (cdr c))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1672 (list (car c) (nth 2 c))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1673 steps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1674 (setq sets (delq nil sets))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1675 (and sets
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1676 (list (cons (if (or star (not (cdr sets)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1677 'setq 'psetq)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1678 (apply 'append sets)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1679 (or (cdr endtest) '(nil)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1680
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1681 ;;;###autoload
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1682 (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
1683 "Loop over a list.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1684 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
1685 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
1686 (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
1687 `(block nil
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1688 (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
1689 (while ,gensym
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1690 (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
1691 ,@body
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1692 (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
1693 ,@(if result `((setq ,var nil) ,result))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1694
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1695 ;;;###autoload
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1696 (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
1697 "Loop a certain number of times.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1698 Evaluate BODY with VAR bound to successive integers from 0, inclusive,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1699 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
1700 nil."
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1701 (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
1702 (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
1703 `(block nil
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1704 (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
1705 (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
1706 ,@body
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1707 (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
1708 ,@(if result (list result))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1709
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1710 ;;;###autoload
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1711 (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
1712 "Loop over all interned symbols.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1713 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
1714 from OBARRAY."
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1715 `(block nil
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1716 (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
1717 ,@(if result `((let (,var) ,result)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1718
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1719 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1720 (defmacro do-all-symbols (spec &rest body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1721 (list* 'do-symbols (list (car spec) nil (cadr spec)) body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1722
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1723
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1724 ;;; Assignments.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1725
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1726 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1727 (defmacro psetq (&rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1728 "(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
1729 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
1730 before assigning any symbols SYM to the corresponding values."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1731 (cons 'psetf args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1732
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1733
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1734 ;;; Binding control structures.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1735
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1736 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1737 (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
1738 "Bind SYMBOLS to VALUES dynamically in BODY.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1739 The forms SYMBOLS and VALUES are evaluated, and must evaluate to lists.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1740 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
1741 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
1742 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
1743 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
1744 (list 'let '((cl-progv-save nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1745 (list 'unwind-protect
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1746 (list* 'progn (list 'cl-progv-before symbols values) body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1747 '(cl-progv-after))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1748
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1749 ;;; This should really have some way to shadow 'byte-compile properties, etc.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1750 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1751 (defmacro flet (bindings &rest body)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1752 "Make temporary function definitions.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1753 This is an analogue of `let' that operates on the function cell of FUNC
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1754 rather than its value cell. The FORMs are evaluated with the specified
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1755 function definitions in place, then the definitions are undone (the FUNCs
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1756 go back to their previous definitions, or lack thereof).
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1757
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1758 arguments: (((FUNC ARGLIST &body BODY) &rest FUNCTIONS) &body FORM)"
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1759 (list* 'letf*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1760 (mapcar
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1761 #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1762 (if (or (and (fboundp (car x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1763 (eq (car-safe (symbol-function (car x))) 'macro))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1764 (cdr (assq (car x) cl-macro-environment)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1765 (error "Use `labels', not `flet', to rebind macro names"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1766 (let ((func (list 'function*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1767 (list 'lambda (cadr x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1768 (list* 'block (car x) (cddr x))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1769 (if (and (cl-compiling-file)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1770 (boundp 'byte-compile-function-environment))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1771 (push (cons (car x) (eval func))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1772 byte-compile-function-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1773 (list (list 'symbol-function (list 'quote (car x))) func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1774 bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1775 body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1776
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1777 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1778 (defmacro labels (bindings &rest body)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1779 "Make temporary func bindings.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1780 This is like `flet', except the bindings are lexical instead of dynamic.
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1781 Unlike `flet', this macro is fully compliant with the Common Lisp standard.
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1782
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1783 arguments: (((FUNC ARGLIST &body BODY) &rest FUNCTIONS) &body FORM)"
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1784 (let ((vars nil) (sets nil) (cl-macro-environment cl-macro-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1785 (while bindings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1786 (let ((var (gensym)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1787 (push var vars)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1788 (push (list 'function* (cons 'lambda (cdar bindings))) sets)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1789 (push var sets)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1790 (push (list (car (pop bindings)) 'lambda '(&rest cl-labels-args)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1791 (list 'list* '(quote funcall) (list 'quote var)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1792 'cl-labels-args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1793 cl-macro-environment)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1794 (cl-macroexpand-all (list* 'lexical-let vars (cons (cons 'setq sets) body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1795 cl-macro-environment)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1796
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1797 ;; The following ought to have a better definition for use with newer
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1798 ;; byte compilers.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1799 ;;;###autoload
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1800 (defmacro* macrolet (((name arglist &optional docstring &body body)
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1801 &rest macros) &body form)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1802 "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
1803 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
1804 (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
1805 (nconc
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1806 (loop
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1807 for (name . details)
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1808 in (cons (list* name arglist docstring body) macros)
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1809 collect
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1810 (list* name 'lambda
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1811 (prog1
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1812 (cdr (setq details (cl-transform-lambda
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1813 details name)))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1814 (eval (car details)))))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1815 cl-macro-environment)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1816
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1817 ;;;###autoload
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1818 (defmacro* symbol-macrolet (((name expansion) &rest symbol-macros) &body form)
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
1819 "Make symbol macro definitions.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1820 Within the body FORMs, references to the variable NAME will be replaced
5326
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1821 by EXPANSION, and (setq NAME ...) will act like (setf EXPANSION ...)."
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1822 (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
1823 (append (list (list (symbol-name name) expansion))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1824 (loop
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1825 for (name expansion) in symbol-macros
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1826 collect (list (symbol-name name) expansion))
60ba780f9078 Use defmacro* when defining dolist, dotimes, do-symbols, macrolet, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5317
diff changeset
1827 cl-macro-environment)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1828
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1829 (defvar cl-closure-vars nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1830 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1831 (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
1832 "Like `let', but lexically scoped.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1833 The main visible difference is that lambdas inside BODY will create
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1834 lexical closures as in Common Lisp."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1835 (let* ((cl-closure-vars cl-closure-vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1836 (vars (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1837 (or (consp x) (setq x (list x)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1838 (push (gensym (format "--%s--" (car x)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1839 cl-closure-vars)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1840 (set (car cl-closure-vars) [bad-lexical-ref])
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1841 (list (car x) (cadr x) (car cl-closure-vars)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1842 bindings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1843 (ebody
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1844 (cl-macroexpand-all
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1845 (cons 'progn body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1846 (nconc (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1847 (list (symbol-name (car x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1848 (list 'symbol-value (caddr x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1849 t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1850 vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1851 (list '(defun . cl-defun-expander))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1852 cl-macro-environment))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1853 (if (not (get (car (last cl-closure-vars)) 'used))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1854 (list 'let (mapcar #'(lambda (x) (list (caddr x) (cadr x))) vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1855 (sublis (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1856 (cons (caddr x) (list 'quote (caddr x))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1857 vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1858 ebody))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1859 (list 'let (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1860 (list (caddr x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1861 (list 'make-symbol
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1862 (format "--%s--" (car x)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1863 vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1864 (apply 'append '(setf)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1865 (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1866 (list (list 'symbol-value (caddr x)) (cadr x)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1867 vars))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1868 ebody))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1869
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1870 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1871 (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
1872 "Like `let*', but lexically scoped.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1873 The main visible difference is that lambdas inside BODY will create
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1874 lexical closures as in Common Lisp."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1875 (if (null bindings) (cons 'progn body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1876 (setq bindings (reverse bindings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1877 (while bindings
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1878 (setq body (list (list* 'lexical-let (list (pop bindings)) body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1879 (car body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1880
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1881 (defun cl-defun-expander (func &rest rest)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1882 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1883 (list 'defalias (list 'quote func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1884 (list 'function (cons 'lambda rest)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1885 (list 'quote func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1886
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1887 ;;; Multiple values. We support full Common Lisp conventions here.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1888
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1889 ;;;###autoload
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1890 (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
1891 "Collect and bind multiple return values.
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1892
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1893 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
1894 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
1895 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
1896 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
1897
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1898 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
1899 (if (null syms)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1900 `(progn ,form ,@body)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1901 (if (= 1 (length syms))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1902 ;; 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
1903 ;; 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
1904 `(let ((,(car syms) ,form))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1905 ,@body)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1906 (let ((temp (gensym)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1907 `(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
1908 ,@(loop
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1909 for var in syms
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1910 collect `(,var (prog1 (car ,temp)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1911 (setq ,temp (cdr ,temp))))))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1912 ,@body)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1913
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1914 ;;;###autoload
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1915 (defmacro multiple-value-setq (syms form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1916 "Collect and set multiple values.
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1917
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1918 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
1919 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
1920 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
1921 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
1922 of SYMS initialized to nil.
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1923
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1924 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
1925 (if (null syms)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1926 ;; 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
1927 (and form `(values ,form))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1928 (if (= 1 (length syms))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1929 `(setq ,(car syms) ,form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1930 (let ((temp (gensym)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1931 `(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
1932 (setq ,@(loop
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1933 for sym in syms
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1934 nconc `(,sym (car-safe ,temp)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1935 ,temp (cdr-safe ,temp))))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1936 ,(car syms))))))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1937
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1938 ;;;###autoload
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1939 (defmacro multiple-value-list (form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1940 "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
1941 `(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
1942
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1943 ;;;###autoload
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1944 (defmacro nth-value (n form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1945 "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
1946 (if (integerp n)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1947 `(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
1948 (let ((temp (gensym)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1949 `(let ((,temp ,n))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
1950 (car (multiple-value-list-internal ,temp (1+ ,temp) ,form))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1951
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1952 ;;; Declarations.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1953
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1954 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1955 (defmacro locally (&rest body) (cons 'progn body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1956 ;;;###autoload
5263
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1957 (defmacro the (type form)
5269
90a0084b3541 Rephrase the #'the docstring, make it nicer while byte-compiling.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5266
diff changeset
1958 "Assert that FORM gives a result of type TYPE, and return that result.
5263
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1959
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1960 TYPE is a Common Lisp type specifier.
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1961
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1962 If macro expansion of a `the' form happens during byte compilation, and the
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1963 byte compiler customization variable `byte-compile-delete-errors' is
5269
90a0084b3541 Rephrase the #'the docstring, make it nicer while byte-compiling.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5266
diff changeset
1964 non-nil, `the' is equivalent to FORM without any type checks."
5263
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1965 (if (cl-safe-expr-p form)
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1966 `(prog1 ,form (assert ,(cl-make-type-test form type) t))
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1967 (let ((saved (gensym)))
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1968 `(let ((,saved ,form))
0d436a78c514 Add an implementation for #'the, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5242
diff changeset
1969 (prog1 ,saved (assert ,(cl-make-type-test saved type) t))))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1970
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1971 (defvar cl-proclaim-history t) ; for future compilers
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1972 (defvar cl-declare-stack t) ; for future compilers
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1973
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1974 (defun cl-do-proclaim (spec hist)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1975 (and hist (listp cl-proclaim-history) (push spec cl-proclaim-history))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1976 (cond ((eq (car-safe spec) 'special)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1977 (if (boundp 'byte-compile-bound-variables)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1978 (setq byte-compile-bound-variables
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
1979 (append
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
1980 ;; XEmacs change
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
1981 (mapcar #'(lambda (v) (cons v byte-compile-global-bit))
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
1982 (cdr spec))
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
1983 byte-compile-bound-variables))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1984
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1985 ((eq (car-safe spec) 'inline)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1986 (while (setq spec (cdr spec))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1987 (or (memq (get (car spec) 'byte-optimizer)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1988 '(nil byte-compile-inline-expand))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1989 (error "%s already has a byte-optimizer, can't make it inline"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1990 (car spec)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1991 (put (car spec) 'byte-optimizer 'byte-compile-inline-expand)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1992
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1993 ((eq (car-safe spec) 'notinline)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1994 (while (setq spec (cdr spec))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1995 (if (eq (get (car spec) 'byte-optimizer)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1996 'byte-compile-inline-expand)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1997 (put (car spec) 'byte-optimizer nil))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1998
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1999 ((eq (car-safe spec) 'optimize)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2000 (let ((speed (assq (nth 1 (assq 'speed (cdr spec)))
446
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
2001 '((0 . nil) (1 . t) (2 . t) (3 . t))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2002 (safety (assq (nth 1 (assq 'safety (cdr spec)))
446
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
2003 '((0 . t) (1 . t) (2 . t) (3 . nil)))))
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
2004 (when speed
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
2005 (setq cl-optimize-speed (car speed)
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
2006 byte-optimize (cdr speed)))
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
2007 (when safety
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
2008 (setq cl-optimize-safety (car safety)
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
2009 byte-compile-delete-errors (cdr safety)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2010
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2011 ((and (eq (car-safe spec) 'warn) (boundp 'byte-compile-warnings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2012 (if (eq byte-compile-warnings t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2013 ;; XEmacs change
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2014 (setq byte-compile-warnings byte-compile-default-warnings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2015 (while (setq spec (cdr spec))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2016 (if (consp (car spec))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2017 (if (eq (cadar spec) 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2018 (setq byte-compile-warnings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2019 (delq (caar spec) byte-compile-warnings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2020 (setq byte-compile-warnings
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2021 (adjoin (caar spec) byte-compile-warnings)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2022 nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2023
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2024 ;;; Process any proclamations made before cl-macs was loaded.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2025 (defvar cl-proclaims-deferred)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2026 (let ((p (reverse cl-proclaims-deferred)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2027 (while p (cl-do-proclaim (pop p) t))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2028 (setq cl-proclaims-deferred nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2029
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2030 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2031 (defmacro declare (&rest specs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2032 (if (cl-compiling-file)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2033 (while specs
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2034 (if (listp cl-declare-stack) (push (car specs) cl-declare-stack))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2035 (cl-do-proclaim (pop specs) nil)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2036 nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2037
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2038
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2039
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2040 ;;; Generalized variables.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2041
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2042 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2043 (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
2044 "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
2045 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
2046 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
2047 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
2048 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
2049 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
2050 form. See `defsetf' for a simpler way to define most setf-methods."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2051 (append '(eval-when (compile load eval))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2052 (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
2053 (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
2054 (pop body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2055 (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
2056 name 'setf-method (cons arglist body)))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2057 (defalias 'define-setf-expander 'define-setf-method)
428
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 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2060 (defmacro defsetf (func arg1 &rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2061 "(defsetf NAME FUNC): define a `setf' method.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2062 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
2063 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
2064 the form (setf (NAME ARGS...) VAL) are transformed to function or macro
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2065 calls of the form (FUNC ARGS... VAL). Example: (defsetf aref aset).
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2066 Alternate form: (defsetf NAME ARGLIST (STORE) BODY...).
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2067 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
2068 according to ARGLIST, binding the value form VAL to STORE, then executing
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2069 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
2070 Actually, ARGLIST and STORE may be bound to temporary variables which are
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2071 introduced automatically to preserve proper execution order of the arguments.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2072 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
2073 (if (listp arg1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2074 (let* ((largs nil) (largsr nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2075 (temps nil) (tempsr nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2076 (restarg nil) (rest-temps nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2077 (store-var (car (prog1 (car args) (setq args (cdr args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2078 (store-temp (intern (format "--%s--temp--" store-var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2079 (lets1 nil) (lets2 nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2080 (docstr nil) (p arg1))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2081 (if (stringp (car args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2082 (setq docstr (prog1 (car args) (setq args (cdr args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2083 (while (and p (not (eq (car p) '&aux)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2084 (if (eq (car p) '&rest)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2085 (setq p (cdr p) restarg (car p))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2086 (or (memq (car p) '(&optional &key &allow-other-keys))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2087 (setq largs (cons (if (consp (car p)) (car (car p)) (car p))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2088 largs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2089 temps (cons (intern (format "--%s--temp--" (car largs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2090 temps))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2091 (setq p (cdr p)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2092 (setq largs (nreverse largs) temps (nreverse temps))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2093 (if restarg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2094 (setq largsr (append largs (list restarg))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2095 rest-temps (intern (format "--%s--temp--" restarg))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2096 tempsr (append temps (list rest-temps)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2097 (setq largsr largs tempsr temps))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2098 (let ((p1 largs) (p2 temps))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2099 (while p1
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2100 (setq lets1 (cons (list (car p2)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2101 (list 'gensym (format "--%s--" (car p1))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2102 lets1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2103 lets2 (cons (list (car p1) (car p2)) lets2)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2104 p1 (cdr p1) p2 (cdr p2))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2105 (if restarg (setq lets2 (cons (list restarg rest-temps) lets2)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2106 (append (list 'define-setf-method func arg1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2107 (and docstr (list docstr))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2108 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2109 (list 'let*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2110 (nreverse
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2111 (cons (list store-temp
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2112 (list 'gensym (format "--%s--" store-var)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2113 (if restarg
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2114 (append
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2115 (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2116 (list rest-temps
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2117 (list 'mapcar '(quote gensym)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2118 restarg)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2119 lets1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2120 lets1)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2121 (list 'list ; 'values
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2122 (cons (if restarg 'list* 'list) tempsr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2123 (cons (if restarg 'list* 'list) largsr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2124 (list 'list store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2125 (cons 'let*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2126 (cons (nreverse
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2127 (cons (list store-var store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2128 lets2))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2129 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2130 (cons (if restarg 'list* 'list)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2131 (cons (list 'quote func) tempsr)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2132 (list 'defsetf func '(&rest args) '(store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2133 (let ((call (list 'cons (list 'quote arg1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2134 '(append args (list store)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2135 (if (car args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2136 (list 'list '(quote progn) call 'store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2137 call)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2138
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2139 ;;; Some standard place types from Common Lisp.
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2140 (eval-when-compile (defvar ignored-arg)) ; XEmacs: warning suppression
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2141 (defsetf aref aset)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2142 (defsetf car setcar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2143 (defsetf cdr setcdr)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2144 (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
2145 (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
2146 (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
2147 (defsetf cddr (x) (val) (list 'setcdr (list 'cdr x) val))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2148 (defsetf elt (seq n) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2149 (list 'if (list 'listp seq) (list 'setcar (list 'nthcdr n seq) store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2150 (list 'aset seq n store)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2151 ;; XEmacs change: ignore the optional DEFAULT arguments
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2152 (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
2153 (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
2154 (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
2155 (defsetf nth (n x) (store) (list 'setcar (list 'nthcdr n x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2156 (defsetf subseq (seq start &optional end) (new)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2157 (list 'progn (list 'replace seq new :start1 start :end1 end) new))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2158 (defsetf symbol-function fset)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2159 (defsetf symbol-plist setplist)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2160 (defsetf symbol-value set)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2161
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2162 ;;; Various car/cdr aliases. Note that `cadr' is handled specially.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2163 (defsetf first setcar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2164 (defsetf second (x) (store) (list 'setcar (list 'cdr x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2165 (defsetf third (x) (store) (list 'setcar (list 'cddr x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2166 (defsetf fourth (x) (store) (list 'setcar (list 'cdddr x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2167 (defsetf fifth (x) (store) (list 'setcar (list 'nthcdr 4 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2168 (defsetf sixth (x) (store) (list 'setcar (list 'nthcdr 5 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2169 (defsetf seventh (x) (store) (list 'setcar (list 'nthcdr 6 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2170 (defsetf eighth (x) (store) (list 'setcar (list 'nthcdr 7 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2171 (defsetf ninth (x) (store) (list 'setcar (list 'nthcdr 8 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2172 (defsetf tenth (x) (store) (list 'setcar (list 'nthcdr 9 x) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2173 (defsetf rest setcdr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2174
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2175 ;;; Some more Emacs-related place types.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2176 (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
2177 ;; 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
2178 (defsetf buffer-modified-p set-buffer-modified-p t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2179 (defsetf buffer-name rename-buffer t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2180 (defsetf buffer-string () (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2181 (list 'progn '(erase-buffer) (list 'insert store)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2182 (defsetf buffer-substring cl-set-buffer-substring)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2183 (defsetf current-buffer set-buffer)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2184 (defsetf current-case-table set-case-table)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2185 (defsetf current-column move-to-column t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2186 (defsetf current-global-map use-global-map t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2187 (defsetf current-input-mode () (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2188 (list 'progn (list 'apply 'set-input-mode store) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2189 (defsetf current-local-map use-local-map t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2190 (defsetf current-window-configuration set-window-configuration t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2191 (defsetf default-file-modes set-default-file-modes t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2192 (defsetf default-value set-default)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2193 (defsetf documentation-property put)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2194 ;;(defsetf extent-data set-extent-data)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2195 (defsetf extent-face set-extent-face)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2196 (defsetf extent-priority set-extent-priority)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2197 ;; XEmacs addition
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2198 (defsetf extent-property (x y &optional ignored-arg) (arg)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2199 (list 'set-extent-property x y arg))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2200 (defsetf extent-end-position (ext) (store)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2201 `(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
2202 ,store))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2203 (defsetf extent-start-position (ext) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2204 `(progn (set-extent-endpoints ,ext ,store (extent-end-position ,ext))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2205 ,store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2206 (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
2207 (defsetf face-background-pixmap (f &optional s) (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2208 (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
2209 (defsetf face-background-placement (f &optional s) (x)
5502045ec510 The background-placement face property.
Didier Verna <didier@lrde.epita.fr>
parents: 5076
diff changeset
2210 (list 'set-face-background-placement f x s))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2211 (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
2212 (defsetf face-foreground (f &optional s) (x) (list 'set-face-foreground f x s))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2213 (defsetf face-underline-p (f &optional s) (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2214 (list 'set-face-underline-p f x s))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2215 (defsetf file-modes set-file-modes t)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2216 (defsetf frame-height (&optional f) (v)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2217 `(progn (set-frame-height ,f ,v) ,v))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2218 (defsetf frame-parameters modify-frame-parameters t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2219 (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
2220 (defsetf frame-width (&optional f) (v)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2221 `(progn (set-frame-width ,f ,v) ,v))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2222 ;; XEmacs change: frame-properties instead of frame-parameters
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2223 (defsetf frame-properties (&optional f) (p)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2224 `(progn (set-frame-properties ,f ,p) ,p))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2225 (defsetf frame-property (f p &optional ignored-arg) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2226 `(progn (set-frame-property ,f ,v) ,p))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2227 ;; XEmacs addition
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2228 (defsetf current-frame-configuration set-frame-configuration)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2229
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2230 ;; XEmacs: new stuff
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2231 ;; Consoles
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2232 (defsetf selected-console select-console t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2233 (defsetf selected-device select-device t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2234 (defsetf device-baud-rate (&optional d) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2235 `(set-device-baud-rate ,d ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2236 ;; This setf method is a bad idea, because set-specifier *adds* a
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2237 ;; specification, rather than just setting it. The net effect is that
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2238 ;; it makes specifier-instance return VAL, but other things don't work
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2239 ;; as expected -- letf, to name one.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2240 ;(defsetf specifier-instance (spec &optional dom def nof) (val)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2241 ; `(set-specifier ,spec ,val ,dom))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2242
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2243 ;; Annotations
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2244 (defsetf annotation-glyph set-annotation-glyph)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2245 (defsetf annotation-down-glyph set-annotation-down-glyph)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2246 (defsetf annotation-face set-annotation-face)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2247 (defsetf annotation-layout set-annotation-layout)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2248 (defsetf annotation-data set-annotation-data)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2249 (defsetf annotation-action set-annotation-action)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2250 (defsetf annotation-menu set-annotation-menu)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2251 ;; Widget
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2252 (defsetf widget-get widget-put t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2253 (defsetf widget-value widget-value-set t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2254
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2255 ;; Misc
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2256 (defsetf recent-keys-ring-size set-recent-keys-ring-size)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2257 (defsetf symbol-value-in-buffer (s b &optional ignored-arg) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2258 `(with-current-buffer ,b (set ,s ,store)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2259 (defsetf symbol-value-in-console (s c &optional ignored-arg) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2260 `(letf (((selected-console) ,c))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2261 (set ,s ,store)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2262
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2263 (defsetf buffer-dedicated-frame (&optional b) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2264 `(set-buffer-dedicated-frame ,b ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2265 (defsetf console-type-image-conversion-list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2266 set-console-type-image-conversion-list)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2267 (defsetf default-toolbar-position set-default-toolbar-position)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2268 (defsetf device-class (&optional d) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2269 `(set-device-class ,d ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2270 (defsetf extent-begin-glyph set-extent-begin-glyph)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2271 (defsetf extent-begin-glyph-layout set-extent-begin-glyph-layout)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2272 (defsetf extent-end-glyph set-extent-end-glyph)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2273 (defsetf extent-end-glyph-layout set-extent-end-glyph-layout)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2274 (defsetf extent-keymap set-extent-keymap)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2275 (defsetf extent-parent set-extent-parent)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2276 (defsetf extent-properties set-extent-properties)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2277 ;; Avoid adding various face and glyph functions.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2278 (defsetf frame-selected-window (&optional f) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2279 `(set-frame-selected-window ,f ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2280 (defsetf glyph-image (glyph &optional domain) (i)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2281 (list 'set-glyph-image glyph i domain))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2282 (defsetf itimer-function set-itimer-function)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2283 (defsetf itimer-function-arguments set-itimer-function-arguments)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2284 (defsetf itimer-is-idle set-itimer-is-idle)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2285 (defsetf itimer-recorded-run-time set-itimer-recorded-run-time)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2286 (defsetf itimer-restart set-itimer-restart)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2287 (defsetf itimer-uses-arguments set-itimer-uses-arguments)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2288 (defsetf itimer-value set-itimer-value)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2289 (defsetf keymap-parents set-keymap-parents)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2290 (defsetf marker-insertion-type set-marker-insertion-type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2291 (defsetf mouse-pixel-position (&optional d) (v)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2292 `(progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2293 (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
2294 ,v))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2295 (defsetf trunc-stack-length set-trunc-stack-length)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2296 (defsetf trunc-stack-stack set-trunc-stack-stack)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2297 (defsetf undoable-stack-max set-undoable-stack-max)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2298 (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
2299 ;; End of new XEmacs stuff
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2300
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2301 (defsetf getenv setenv t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2302 (defsetf get-register set-register)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2303 (defsetf global-key-binding global-set-key)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2304 (defsetf keymap-parent set-keymap-parent)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2305 ;; XEmacs addition: more keymap-related setf forms
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2306 (defsetf keymap-name set-keymap-name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2307 (defsetf keymap-prompt set-keymap-prompt)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2308 (defsetf keymap-default-binding set-keymap-default-binding)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2309 (defsetf local-key-binding local-set-key)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2310 (defsetf mark set-mark t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2311 (defsetf mark-marker set-mark t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2312 (defsetf marker-position set-marker t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2313 (defsetf match-data store-match-data t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2314 (defsetf mouse-position (scr) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2315 (list 'set-mouse-position scr (list 'car store) (list 'cadr store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2316 (list 'cddr store)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2317 (defsetf overlay-get overlay-put)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2318 (defsetf overlay-start (ov) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2319 (list 'progn (list 'move-overlay ov store (list 'overlay-end ov)) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2320 (defsetf overlay-end (ov) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2321 (list 'progn (list 'move-overlay ov (list 'overlay-start ov) store) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2322 (defsetf point goto-char)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2323 (defsetf point-marker goto-char t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2324 (defsetf point-max () (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2325 (list 'progn (list 'narrow-to-region '(point-min) store) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2326 (defsetf point-min () (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2327 (list 'progn (list 'narrow-to-region store '(point-max)) store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2328 (defsetf process-buffer set-process-buffer)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2329 (defsetf process-filter set-process-filter)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2330 (defsetf process-sentinel set-process-sentinel)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2331 ;;(defsetf process-get process-put)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2332 (defsetf read-mouse-position (scr) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2333 (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
2334 ;;(defsetf screen-height set-screen-height t)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2335 ;;(defsetf screen-width set-screen-width t)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2336 (defsetf selected-window select-window)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2337 ;;(defsetf selected-screen select-screen)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2338 (defsetf selected-frame select-frame)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2339 (defsetf standard-case-table set-standard-case-table)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2340 (defsetf syntax-table set-syntax-table)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2341 (defsetf visited-file-modtime set-visited-file-modtime t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2342 (defsetf window-buffer set-window-buffer t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2343 (defsetf window-display-table set-window-display-table t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2344 (defsetf window-dedicated-p set-window-dedicated-p t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2345 (defsetf window-height (&optional window) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2346 `(progn (enlarge-window (- ,store (window-height)) nil ,window) ,store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2347 (defsetf window-hscroll set-window-hscroll)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2348 (defsetf window-point set-window-point)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2349 (defsetf window-start set-window-start)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2350 (defsetf window-width (&optional window) (store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2351 `(progn (enlarge-window (- ,store (window-width)) t ,window) ,store))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2352 (defsetf x-get-cutbuffer x-store-cutbuffer t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2353 (defsetf x-get-cut-buffer x-store-cut-buffer t) ; groan.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2354 (defsetf x-get-secondary-selection x-own-secondary-selection t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2355 (defsetf x-get-selection x-own-selection t)
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
2356 (defsetf get-selection own-selection t)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2357
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2358 ;;; More complex setf-methods.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2359 ;;; These should take &environment arguments, but since full arglists aren't
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2360 ;;; available while compiling cl-macs, we fake it by referring to the global
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2361 ;;; variable cl-macro-environment directly.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2362
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2363 (define-setf-method apply (func arg1 &rest rest)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2364 (or (and (memq (car-safe func) '(quote function function*))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2365 (symbolp (car-safe (cdr-safe func))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2366 (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
2367 (let* ((form (cons (nth 1 func) (cons arg1 rest)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2368 (method (get-setf-method form cl-macro-environment)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2369 (list (car method) (nth 1 method) (nth 2 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2370 (cl-setf-make-apply (nth 3 method) (cadr func) (car method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2371 (cl-setf-make-apply (nth 4 method) (cadr func) (car method)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2372
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2373 (defun cl-setf-make-apply (form func temps)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2374 (if (eq (car form) 'progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2375 (list* 'progn (cl-setf-make-apply (cadr form) func temps) (cddr form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2376 (or (equal (last form) (last temps))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2377 (error "%s is not suitable for use with setf-of-apply" func))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2378 (list* 'apply (list 'quote (car form)) (cdr form))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2379
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2380 (define-setf-method nthcdr (n place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2381 (let ((method (get-setf-method place cl-macro-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2382 (n-temp (gensym "--nthcdr-n--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2383 (store-temp (gensym "--nthcdr-store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2384 (list (cons n-temp (car method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2385 (cons n (nth 1 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2386 (list store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2387 (list 'let (list (list (car (nth 2 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2388 (list 'cl-set-nthcdr n-temp (nth 4 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2389 store-temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2390 (nth 3 method) store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2391 (list 'nthcdr n-temp (nth 4 method)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2392
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2393 (define-setf-method getf (place tag &optional def)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2394 (let ((method (get-setf-method place cl-macro-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2395 (tag-temp (gensym "--getf-tag--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2396 (def-temp (gensym "--getf-def--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2397 (store-temp (gensym "--getf-store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2398 (list (append (car method) (list tag-temp def-temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2399 (append (nth 1 method) (list tag def))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2400 (list store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2401 (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
2402 (list 'plist-put (nth 4 method)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2403 tag-temp store-temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2404 (nth 3 method) store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2405 (list 'getf (nth 4 method) tag-temp def-temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2406
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2407 (define-setf-method substring (place from &optional to)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2408 (let ((method (get-setf-method place cl-macro-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2409 (from-temp (gensym "--substring-from--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2410 (to-temp (gensym "--substring-to--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2411 (store-temp (gensym "--substring-store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2412 (list (append (car method) (list from-temp to-temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2413 (append (nth 1 method) (list from to))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2414 (list store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2415 (list 'let (list (list (car (nth 2 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2416 (list 'cl-set-substring (nth 4 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2417 from-temp to-temp store-temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2418 (nth 3 method) store-temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2419 (list 'substring (nth 4 method) from-temp to-temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2420
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2421 ;; XEmacs addition
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2422 (define-setf-method values (&rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2423 (let ((methods (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2424 (get-setf-method x cl-macro-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2425 args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2426 (store-temp (gensym "--values-store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2427 (list (apply 'append (mapcar 'first methods))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2428 (apply 'append (mapcar 'second methods))
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2429 `((,store-temp
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2430 (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
2431 (cons 'values
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2432 (mapcar #'(lambda (m)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2433 (cl-setf-do-store (cons (car (third m)) (fourth m))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2434 (list 'pop store-temp)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2435 methods))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2436 (cons 'list (mapcar 'fifth methods)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2437
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2438 ;;; Getting and optimizing setf-methods.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2439 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2440 (defun get-setf-method (place &optional env)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2441 "Return a list of five values describing the setf-method for PLACE.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2442 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
2443 a macro like `setf' or `incf'."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2444 (if (symbolp place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2445 (let ((temp (gensym "--setf--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2446 (list nil nil (list temp) (list 'setq place temp) place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2447 (or (and (symbolp (car place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2448 (let* ((func (car place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2449 (name (symbol-name func))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2450 (method (get func 'setf-method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2451 (case-fold-search nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2452 (or (and method
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2453 (let ((cl-macro-environment env))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2454 (setq method (apply method (cdr place))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2455 (if (and (consp method) (= (length method) 5))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2456 method
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2457 (error "Setf-method for %s returns malformed method"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2458 func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2459 (and (save-match-data
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2460 (string-match "\\`c[ad][ad][ad]?[ad]?r\\'" name))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2461 (get-setf-method (compiler-macroexpand place)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2462 (and (eq func 'edebug-after)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2463 (get-setf-method (nth (1- (length place)) place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2464 env)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2465 (if (eq place (setq place (macroexpand place env)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2466 (if (and (symbolp (car place)) (fboundp (car place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2467 (symbolp (symbol-function (car place))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2468 (get-setf-method (cons (symbol-function (car place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2469 (cdr place)) env)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2470 (error "No setf-method known for %s" (car place)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2471 (get-setf-method place env)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2472
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2473 (defun cl-setf-do-modify (place opt-expr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2474 (let* ((method (get-setf-method place cl-macro-environment))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2475 (temps (car method)) (values (nth 1 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2476 (lets nil) (subs nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2477 (optimize (and (not (eq opt-expr 'no-opt))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2478 (or (and (not (eq opt-expr 'unsafe))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2479 (cl-safe-expr-p opt-expr))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2480 (cl-setf-simple-store-p (car (nth 2 method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2481 (nth 3 method)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2482 (simple (and optimize (consp place) (cl-simple-exprs-p (cdr place)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2483 (while values
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2484 (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
2485 (push (cons (pop temps) (pop values)) subs)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2486 (push (list (pop temps) (pop values)) lets)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2487 (list (nreverse lets)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2488 (cons (car (nth 2 method)) (sublis subs (nth 3 method)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2489 (sublis subs (nth 4 method)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2490
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2491 (defun cl-setf-do-store (spec val)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2492 (let ((sym (car spec))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2493 (form (cdr spec)))
4677
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2494 (if (consp sym)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2495 ;; 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
2496 (let* ((orig (copy-list sym))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2497 (intermediate (last orig))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2498 (circular-limit 32))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2499 (while (consp (car intermediate))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2500 (when (zerop circular-limit)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2501 (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
2502 (setq intermediate (last (car intermediate))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2503 circular-limit (1- circular-limit)))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2504 (setcdr intermediate (list val))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2505 `(let (,orig)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2506 ,form))
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2507 (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
2508 (and (cl-simple-expr-p val)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2509 (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
2510 (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
2511 (subst val sym form)
8f1ee2d15784 Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4607
diff changeset
2512 (list 'let (list (list sym val)) form)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2513
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2514 (defun cl-setf-simple-store-p (sym form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2515 (and (consp form) (eq (cl-expr-contains form sym) 1)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2516 (eq (nth (1- (length form)) form) sym)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2517 (symbolp (car form)) (fboundp (car form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2518 (not (eq (car-safe (symbol-function (car form))) 'macro))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2519
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2520 ;;; The standard modify macros.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2521 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2522 (defmacro setf (&rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2523 "(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
2524 This is a generalized version of `setq'; the PLACEs may be symbolic
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2525 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
2526 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
2527 The return value is the last VAL in the list."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2528 (if (cdr (cdr args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2529 (let ((sets nil))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2530 (while args (push (list 'setf (pop args) (pop args)) sets))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2531 (cons 'progn (nreverse sets)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2532 (if (symbolp (car args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2533 (and args (cons 'setq args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2534 (let* ((method (cl-setf-do-modify (car args) (nth 1 args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2535 (store (cl-setf-do-store (nth 1 method) (nth 1 args))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2536 (if (car method) (list 'let* (car method) store) store)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2537
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2538 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2539 (defmacro psetf (&rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2540 "(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
2541 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
2542 before assigning any PLACEs to the corresponding values."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2543 (let ((p args) (simple t) (vars nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2544 (while p
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2545 (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
2546 (setq simple nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2547 (if (memq (car p) vars)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2548 (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
2549 (push (pop p) vars)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2550 (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
2551 (pop p))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2552 (if simple
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2553 (list 'progn (cons 'setf args) nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2554 (setq args (reverse args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2555 (let ((expr (list 'setf (cadr args) (car args))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2556 (while (setq args (cddr args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2557 (setq expr (list 'setf (cadr args) (list 'prog1 (car args) expr))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2558 (list 'progn expr nil)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2559
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2560 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2561 (defun cl-do-pop (place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2562 (if (cl-simple-expr-p place)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2563 (list 'prog1 (list 'car place) (list 'setf place (list 'cdr place)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2564 (let* ((method (cl-setf-do-modify place t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2565 (temp (gensym "--pop--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2566 (list 'let*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2567 (append (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2568 (list (list temp (nth 2 method))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2569 (list 'prog1
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2570 (list 'car temp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2571 (cl-setf-do-store (nth 1 method) (list 'cdr temp)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2572
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2573 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2574 (defmacro remf (place tag)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
2575 "Remove TAG from property list PLACE.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2576 PLACE may be a symbol, or any generalized variable allowed by `setf'.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2577 The form returns true if TAG was found and removed, nil otherwise."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2578 (let* ((method (cl-setf-do-modify place t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2579 (tag-temp (and (not (cl-const-expr-p tag)) (gensym "--remf-tag--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2580 (val-temp (and (not (cl-simple-expr-p place))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2581 (gensym "--remf-place--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2582 (ttag (or tag-temp tag))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2583 (tval (or val-temp (nth 2 method))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2584 (list 'let*
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2585 (append (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2586 (and val-temp (list (list val-temp (nth 2 method))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2587 (and tag-temp (list (list tag-temp tag))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2588 (list 'if (list 'eq ttag (list 'car tval))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2589 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2590 (cl-setf-do-store (nth 1 method) (list 'cddr tval))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2591 t)
5285
99de5fd48e87 Tighten up Common Lisp compatibility, #'butlast, #'nbutlast, #'tailp, #'ldiff
Aidan Kehoe <kehoea@parhasard.net>
parents: 5269
diff changeset
2592 (list 'plist-remprop tval ttag)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2593
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2594 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2595 (defmacro shiftf (place &rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2596 "(shiftf PLACE PLACE... VAL): shift left among PLACEs.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2597 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
2598 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
2599 ;; XEmacs change: use iteration instead of recursion
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2600 (if (not (memq nil (mapcar 'symbolp (butlast (cons place args)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2601 (list* 'prog1 place
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2602 (let ((sets nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2603 (while args
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2604 (push (list 'setq place (car args)) sets)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2605 (setq place (pop args)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2606 (nreverse sets)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2607 (let* ((places (reverse (cons place args)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2608 (form (pop places)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2609 (while places
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2610 (let ((method (cl-setf-do-modify (pop places) 'unsafe)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2611 (setq form (list 'let* (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2612 (list 'prog1 (nth 2 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2613 (cl-setf-do-store (nth 1 method) form))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2614 form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2615
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2616 ;;;###autoload
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2617 (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
2618 "Rotate left among PLACES.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2619 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
2620 Each PLACE may be a symbol, or any generalized variable allowed by `setf'."
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2621 (if (not (memq nil (mapcar 'symbolp places)))
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2622 (and (cdr places)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2623 (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
2624 (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
2625 (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
2626 (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
2627 (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
2628 (let* ((places (reverse places))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2629 (temp (gensym "--rotatef--"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2630 (form temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2631 (while (cdr places)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2632 (let ((method (cl-setf-do-modify (pop places) 'unsafe)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2633 (setq form (list 'let* (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2634 (list 'prog1 (nth 2 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2635 (cl-setf-do-store (nth 1 method) form))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2636 (let ((method (cl-setf-do-modify (car places) 'unsafe)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2637 (list 'let* (append (car method) (list (list temp (nth 2 method))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2638 (cl-setf-do-store (nth 1 method) form) nil)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2639
4742
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2640 ;; 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
2641 ;; 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
2642 ;; 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
2643 ;; 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
2644 ;; 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
2645 ;; 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
2646 ;; 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
2647 ;; wrong behaviour for gethash:
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2648 ;;
4820
e6dec75ded0e Use keywords, not ordinary symbols, in the structure syntax for hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4810
diff changeset
2649 ;; (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
2650 ;; print-gensym t)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2651 ;; => t
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2652 ;; (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
2653 ;; => #:G68010
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2654 ;; (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
2655 ;; (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
2656 ;; => "key value is 4000"
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2657 ;; (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
2658 ;; => 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
2659 ;;
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2660 ;; 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
2661
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2662 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2663 (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
2664 "Temporarily bind to PLACEs.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2665 This is the analogue of `let', but with generalized variables (in the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2666 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
2667 VALUE, then the BODY forms are executed. On exit, either normally or
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2668 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
2669 values. Note that this macro is *not* available in Common Lisp.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2670 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
2671 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
2672
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2673 arguments: (((PLACE VALUE) &rest BINDINGS) &body BODY)"
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2674 (if (and (not (cdr bindings)) (cdar bindings) (symbolp (caar bindings)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2675 (list* 'let bindings body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2676 (let ((lets nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2677 (rev (reverse bindings)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2678 (while rev
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2679 (let* ((place (if (symbolp (caar rev))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2680 (list 'symbol-value (list 'quote (caar rev)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2681 (caar rev)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2682 (value (cadar rev))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2683 (method (cl-setf-do-modify place 'no-opt))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2684 (save (gensym "--letf-save--"))
4742
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2685 (bound (and (memq (car place)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2686 '(symbol-value symbol-function values))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2687 (gensym "--letf-bound--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2688 (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
2689 (gensym "--letf-val--")))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2690 (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
2691 (gensym "--letf-syms--")))
4783
e29fcfd8df5f Eliminate most core code byte-compile warnings.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4742
diff changeset
2692 (cursor (and syms (gensym "--letf-cursor--"))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2693 (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
2694 (cond
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2695 (syms
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2696 `((,syms ',(loop
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2697 for sym in (cdr place)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2698 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
2699 (,cursor ,syms)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2700 (,bound nil)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2701 (,save
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2702 (prog2
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2703 (while (consp ,cursor)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2704 (setq ,bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2705 (cons (and (boundp (car ,cursor))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2706 (symbol-value
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2707 (car ,cursor)))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2708 ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2709 ,cursor (cdr ,cursor)))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2710 ;; 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
2711 ;; variable here, to initialise ,save:
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2712 (nreverse ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2713 ;; Now, really initialise ,bound:
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2714 (setq ,cursor ,syms
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2715 ,bound nil
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2716 ,bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2717 (progn (while (consp ,cursor)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2718 (setq ,bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2719 (cons
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2720 (boundp (car ,cursor))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2721 ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2722 ,cursor (cdr ,cursor)))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2723 (nreverse ,bound)))))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2724 (bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2725 (list (list bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2726 (list (if (eq (car place)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2727 'symbol-value)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2728 'boundp 'fboundp)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2729 (nth 1 (nth 2 method))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2730 (list save (list 'and bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2731 (nth 2 method)))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2732 (t
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2733 (list (list save (nth 2 method)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2734 (and temp (list (list temp value)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2735 lets)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2736 body (list
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2737 (list 'unwind-protect
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2738 (cons 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2739 (if (cdr (car rev))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2740 (cons (cl-setf-do-store (nth 1 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2741 (or temp value))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2742 body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2743 body))
4742
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2744 (cond
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2745 (syms
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2746 `(while (consp ,syms)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2747 (if (car ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2748 (set (car ,syms) (car ,save))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2749 (makunbound (car ,syms)))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2750 (setq ,syms (cdr ,syms)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2751 ,bound (cdr ,bound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2752 ,save (cdr ,save))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2753 (bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2754 (list 'if bound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2755 (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
2756 (list (if (eq (car place)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2757 'symbol-function)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2758 'fmakunbound
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2759 'makunbound)
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2760 (nth 1 (nth 2 method)))))
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2761 (t
4cf435fcebbc Make #'letf not error if handed a #'values form.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4723
diff changeset
2762 (cl-setf-do-store (nth 1 method) save)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2763 rev (cdr rev))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2764 (list* 'let* lets body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2765
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2766 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2767 (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
2768 "Temporarily bind to PLACES.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2769 This is the analogue of `let*', but with generalized variables (in the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2770 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
2771 VALUE, then the BODY forms are executed. On exit, either normally or
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2772 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
2773 values. Note that this macro is *not* available in Common Lisp.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2774 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
2775 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
2776
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
2777 arguments: (((PLACE VALUE) &rest BINDINGS) &body BODY)"
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2778 (if (null bindings)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2779 (cons 'progn body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2780 (setq bindings (reverse bindings))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2781 (while bindings
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2782 (setq body (list (list* 'letf (list (pop bindings)) body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2783 (car body)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2784
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2785 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2786 (defmacro callf (func place &rest args)
4695
fee33ab25966 Add arglist info for autoloaded functions and macros.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4694
diff changeset
2787 "Set PLACE to (FUNC PLACE ARGS...).
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2788 FUNC should be an unquoted function name. PLACE may be a symbol,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2789 or any generalized variable allowed by `setf'."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2790 (let* ((method (cl-setf-do-modify place (cons 'list args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2791 (rargs (cons (nth 2 method) args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2792 (list 'let* (car method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2793 (cl-setf-do-store (nth 1 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2794 (if (symbolp func) (cons func rargs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2795 (list* 'funcall (list 'function func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2796 rargs))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2797
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2798 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2799 (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
2800 "Set PLACE to (FUNC ARG1 PLACE ARGS...).
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2801 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
2802 (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
2803 (list 'setf place (list* func arg1 place args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2804 (let* ((method (cl-setf-do-modify place (cons 'list args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2805 (temp (and (not (cl-const-expr-p arg1)) (gensym "--arg1--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2806 (rargs (list* (or temp arg1) (nth 2 method) args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2807 (list 'let* (append (and temp (list (list temp arg1))) (car method))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2808 (cl-setf-do-store (nth 1 method)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2809 (if (symbolp func) (cons func rargs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2810 (list* 'funcall (list 'function func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2811 rargs)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2812
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2813 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2814 (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
2815 "Define a `setf'-like modify macro.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2816 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
2817 from ARGLIST using FUNC: (define-modify-macro incf (&optional (n 1)) +)"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2818 (if (memq '&key arglist) (error "&key not allowed in define-modify-macro"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2819 (let ((place (gensym "--place--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2820 (list 'defmacro* name (cons place arglist) doc
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2821 (list* (if (memq '&rest arglist) 'list* 'list)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2822 '(quote callf) (list 'quote func) place
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2823 (cl-arglist-args arglist)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2824
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2825
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2826 ;;; Structures.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2827
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2828 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2829 (defmacro defstruct (struct &rest descs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2830 "(defstruct (NAME OPTIONS...) (SLOT SLOT-OPTS...)...): define a struct type.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2831 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
2832 stored in SLOTs. This defines a `make-NAME' constructor, a `copy-NAME'
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2833 copier, a `NAME-p' predicate, and setf-able `NAME-SLOT' accessors."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2834 (let* ((name (if (consp struct) (car struct) struct))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2835 (opts (cdr-safe struct))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2836 (slots nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2837 (defaults nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2838 (conc-name (concat (symbol-name name) "-"))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2839 (constructor (intern (format "make-%s" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2840 (constrs nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2841 (copier (intern (format "copy-%s" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2842 (predicate (intern (format "%s-p" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2843 (print-func nil) (print-auto nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2844 (safety (if (cl-compiling-file) cl-optimize-safety 3))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2845 (include nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2846 (tag (intern (format "cl-struct-%s" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2847 (tag-symbol (intern (format "cl-struct-%s-tags" name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2848 (include-descs nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2849 (side-eff nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2850 (type nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2851 (named nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2852 (forms nil)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2853 pred-form pred-check)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2854 (if (stringp (car descs))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2855 (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
2856 (pop descs)) forms))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2857 (setq descs (cons '(cl-tag-slot)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2858 (mapcar #'(lambda (x) (if (consp x) x (list x)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2859 descs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2860 (while opts
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2861 (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
2862 (args (cdr-safe (pop opts))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2863 (cond ((eq opt :conc-name)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2864 (if args
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2865 (setq conc-name (if (car args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2866 (symbol-name (car args)) ""))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2867 ((eq opt :constructor)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2868 (if (cdr args)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2869 (push args constrs)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2870 (if args (setq constructor (car args)))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2871 ((eq opt :copier)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2872 (if args (setq copier (car args))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2873 ((eq opt :predicate)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2874 (if args (setq predicate (car args))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2875 ((eq opt :include)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2876 (setq include (car args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2877 include-descs (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2878 (if (consp x) x (list x)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2879 (cdr args))))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2880 ((eq opt :print-function)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2881 (setq print-func (car args)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2882 ((eq opt :type)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2883 (setq type (car args)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2884 ((eq opt :named)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2885 (setq named t))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2886 ((eq opt :initial-offset)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2887 (setq descs (nconc (make-list (car args) '(cl-skip-slot))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2888 descs)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2889 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2890 (error "Slot option %s unrecognized" opt)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2891 (if print-func
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2892 (setq print-func (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2893 (list 'funcall (list 'function print-func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2894 'cl-x 'cl-s 'cl-n) t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2895 (or type (and include (not (get include 'cl-struct-print)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2896 (setq print-auto t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2897 print-func (and (or (not (or include type)) (null print-func))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2898 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2899 (list 'princ (format "#S(%s" name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2900 'cl-s))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2901 (if include
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2902 (let ((inc-type (get include 'cl-struct-type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2903 (old-descs (get include 'cl-struct-slots)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2904 (or inc-type (error "%s is not a struct name" include))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2905 (and type (not (eq (car inc-type) type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2906 (error ":type disagrees with :include for %s" name))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2907 (while include-descs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2908 (setcar (memq (or (assq (caar include-descs) old-descs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2909 (error "No slot %s in included struct %s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2910 (caar include-descs) include))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2911 old-descs)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2912 (pop include-descs)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2913 (setq descs (append old-descs (delq (assq 'cl-tag-slot descs) descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2914 type (car inc-type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2915 named (assq 'cl-tag-slot descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2916 (if (cadr inc-type) (setq tag name named t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2917 (let ((incl include))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2918 (while incl
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2919 (push (list 'pushnew (list 'quote tag)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2920 (intern (format "cl-struct-%s-tags" incl)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2921 forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2922 (setq incl (get incl 'cl-struct-include)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2923 (if type
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2924 (progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2925 (or (memq type '(vector list))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2926 (error "Illegal :type specifier: %s" type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2927 (if named (setq tag name)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2928 (setq type 'vector named 'true)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2929 (or named (setq descs (delq (assq 'cl-tag-slot descs) descs)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2930 (push (list 'defvar tag-symbol) forms)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2931 (setq pred-form (and named
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2932 (let ((pos (- (length descs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2933 (length (memq (assq 'cl-tag-slot descs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2934 descs)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2935 (if (eq type 'vector)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2936 (list 'and '(vectorp cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2937 (list '>= '(length cl-x) (length descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2938 (list 'memq (list 'aref 'cl-x pos)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2939 tag-symbol))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2940 (if (= pos 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2941 (list 'memq '(car-safe cl-x) tag-symbol)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2942 (list 'and '(consp cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2943 (list 'memq (list 'nth pos 'cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2944 tag-symbol))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2945 pred-check (and pred-form (> safety 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2946 (if (and (eq (caadr pred-form) 'vectorp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2947 (= safety 1))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2948 (cons 'and (cdddr pred-form)) pred-form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2949 (let ((pos 0) (descp descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2950 (while descp
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2951 (let* ((desc (pop descp))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2952 (slot (car desc)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2953 (if (memq slot '(cl-tag-slot cl-skip-slot))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2954 (progn
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2955 (push nil slots)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2956 (push (and (eq slot 'cl-tag-slot) (list 'quote tag))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2957 defaults))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2958 (if (assq slot descp)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2959 (error "Duplicate slots named %s in %s" slot name))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2960 (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
2961 (push slot slots)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2962 (push (nth 1 desc) defaults)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2963 (push (list*
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2964 'defsubst* accessor '(cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2965 (append
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2966 (and pred-check
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2967 (list (list 'or pred-check
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2968 (list 'error
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2969 (format "%s accessing a non-%s"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2970 accessor name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2971 'cl-x))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2972 (list (if (eq type 'vector) (list 'aref 'cl-x pos)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2973 (if (= pos 0) '(car cl-x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2974 (list 'nth pos 'cl-x)))))) forms)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2975 (push (cons accessor t) side-eff)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2976 (push (list 'define-setf-method accessor '(cl-x)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2977 (if (cadr (memq :read-only (cddr desc)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2978 (list 'error (format "%s is a read-only slot"
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2979 accessor))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2980 (list 'cl-struct-setf-expander 'cl-x
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2981 (list 'quote name) (list 'quote accessor)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2982 (and pred-check (list 'quote pred-check))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2983 pos)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2984 forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2985 (if print-auto
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2986 (nconc print-func
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2987 (list (list 'princ (format " %s" slot) 'cl-s)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2988 (list 'prin1 (list accessor 'cl-x) 'cl-s)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2989 (setq pos (1+ pos))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2990 (setq slots (nreverse slots)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2991 defaults (nreverse defaults))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2992 (and predicate pred-form
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2993 (progn (push (list 'defsubst* predicate '(cl-x)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2994 (if (eq (car pred-form) 'and)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2995 (append pred-form '(t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2996 (list 'and pred-form t))) forms)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2997 (push (cons predicate 'error-free) side-eff)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2998 (and copier
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
2999 (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
3000 (push (cons copier t) side-eff)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3001 (if constructor
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3002 (push (list constructor
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3003 (cons '&key (delq nil (copy-sequence slots))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3004 constrs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3005 (while constrs
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3006 (let* ((name (caar constrs))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3007 (args (cadr (pop constrs)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3008 (anames (cl-arglist-args args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3009 (make (mapcar* #'(lambda (s d) (if (memq s anames) s d))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3010 slots defaults)))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3011 (push (list 'defsubst* name
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3012 (list* '&cl-defs (list 'quote (cons nil descs)) args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3013 (cons type make)) forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3014 (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
3015 (push (cons name t) side-eff))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3016 (if print-auto (nconc print-func (list '(princ ")" cl-s) t)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3017 (if print-func
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3018 (push (list 'push
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3019 (list 'function
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3020 (list 'lambda '(cl-x cl-s cl-n)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3021 (list 'and pred-form print-func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3022 'custom-print-functions) forms))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3023 (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
3024 (push (list* 'eval-when '(compile load eval)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3025 (list 'put (list 'quote name) '(quote cl-struct-slots)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3026 (list 'quote descs))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3027 (list 'put (list 'quote name) '(quote cl-struct-type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3028 (list 'quote (list type (eq named t))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3029 (list 'put (list 'quote name) '(quote cl-struct-include)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3030 (list 'quote include))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3031 (list 'put (list 'quote name) '(quote cl-struct-print)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3032 print-auto)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3033 (mapcar #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3034 (list 'put (list 'quote (car x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3035 '(quote side-effect-free)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3036 (list 'quote (cdr x))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3037 side-eff))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3038 forms)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3039 (cons 'progn (nreverse (cons (list 'quote name) forms)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3040
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3041 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3042 (defun cl-struct-setf-expander (x name accessor pred-form pos)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3043 (let* ((temp (gensym "--x--")) (store (gensym "--store--")))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3044 (list (list temp) (list x) (list store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3045 (append '(progn)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3046 (and pred-form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3047 (list (list 'or (subst temp 'cl-x pred-form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3048 (list 'error
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3049 (format
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3050 "%s storing a non-%s" accessor name)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3051 temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3052 (list (if (eq (car (get name 'cl-struct-type)) 'vector)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3053 (list 'aset temp pos store)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3054 (list 'setcar
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3055 (if (<= pos 5)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3056 (let ((xx temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3057 (while (>= (setq pos (1- pos)) 0)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3058 (setq xx (list 'cdr xx)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3059 xx)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3060 (list 'nthcdr pos temp))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3061 store))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3062 (list accessor temp))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3063
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3064
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3065 ;;; Types and assertions.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3066
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3067 ;;;###autoload
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3068 (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
3069 "Define NAME as a new data type.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3070 The type name can then be used in `typecase', `check-type', etc."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3071 (list 'eval-when '(compile load eval)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3072 (cl-transform-function-property
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3073 name 'cl-deftype-handler (cons (list* '&cl-defs ''('*) arglist) body))))
428
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 (defun cl-make-type-test (val type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3076 (if (symbolp type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3077 (cond ((get type 'cl-deftype-handler)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3078 (cl-make-type-test val (funcall (get type 'cl-deftype-handler))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3079 ((memq type '(nil t)) type)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3080 ((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
3081 ((eq type 'float) `(floatp ,val))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3082 ((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
3083 ((eq type 'fixnum) `(fixnump ,val))
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3084 ;; 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
3085 ((memq type '(character string-char)) `(characterp ,val))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3086 (t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3087 (let* ((name (symbol-name type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3088 (namep (intern (concat name "p"))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3089 (if (fboundp namep) (list namep val)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3090 (list (intern (concat name "-p")) val)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3091 (cond ((get (car type) 'cl-deftype-handler)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3092 (cl-make-type-test val (apply (get (car type) 'cl-deftype-handler)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3093 (cdr type))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3094 ((memq (car-safe type) '(integer float real number))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3095 (delq t (list 'and (cl-make-type-test val (car type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3096 (if (memq (cadr type) '(* nil)) t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3097 (if (consp (cadr type)) (list '> val (caadr type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3098 (list '>= val (cadr type))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3099 (if (memq (caddr type) '(* nil)) t
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3100 (if (consp (caddr type)) (list '< val (caaddr type))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3101 (list '<= val (caddr type)))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3102 ((memq (car-safe type) '(and or not))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3103 (cons (car type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3104 (mapcar #'(lambda (x) (cl-make-type-test val x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3105 (cdr type))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3106 ((memq (car-safe type) '(member member*))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3107 (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
3108 ((eq (car-safe type) 'eql)
09fed7053634 Handle slightly more complex type specifications, #'coerce, #'typep.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5301
diff changeset
3109 (list 'eql (cadr type) val))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3110 ((eq (car-safe type) 'satisfies) (list (cadr type) val))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3111 (t (error "Bad type spec: %s" type)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3112
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3113 ;;;###autoload
444
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 442
diff changeset
3114 (defun typep (object type) ; See compiler macro below.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3115 "Check that OBJECT is of type TYPE.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3116 TYPE is a Common Lisp-style type specifier."
444
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 442
diff changeset
3117 (eval (cl-make-type-test 'object type)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3118
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3119 ;;;###autoload
446
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
3120 (defmacro check-type (place type &optional string)
1ccc32a20af4 Import from CVS: tag r21-2-38
cvs
parents: 444
diff changeset
3121 "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
3122 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
3123 (and (or (not (cl-compiling-file))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3124 (< cl-optimize-speed 3) (= cl-optimize-safety 3))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3125 (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
3126 (test (cl-make-type-test temp type))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3127 (signal-error `(signal 'wrong-type-argument
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3128 ,(list 'list (or string (list 'quote type))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3129 temp (list 'quote place))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3130 (body
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3131 (condition-case nil
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3132 `(while (not ,test)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3133 ,(macroexpand `(setf ,place ,signal-error)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3134 (error
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3135 `(if ,test (progn ,signal-error nil))))))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3136 (if (eq temp place) `(progn ,body nil)
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3137 `(let ((,temp ,place)) ,body nil)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3138
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3139 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3140 (defmacro assert (form &optional show-args string &rest args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3141 "Verify that FORM returns non-nil; signal an error if not.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3142 Second arg SHOW-ARGS means to include arguments of FORM in message.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3143 Other args STRING and ARGS... are arguments to be passed to `error'.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3144 They are not evaluated unless the assertion fails. If STRING is
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3145 omitted, a default message listing FORM itself is used."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3146 (and (or (not (cl-compiling-file))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3147 (< cl-optimize-speed 3) (= cl-optimize-safety 3))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3148 (let ((sargs (and show-args (delq nil (mapcar
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3149 #'(lambda (x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3150 (and (not (cl-const-expr-p x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3151 x))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3152 (cdr form))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3153 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3154 (list 'or form
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3155 (if string
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3156 (list* 'error string (append sargs args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3157 (list 'signal '(quote cl-assertion-failed)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3158 (list* 'list (list 'quote form) sargs))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3159 nil))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3160
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3161 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3162 (defmacro ignore-errors (&rest body)
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3163 "Execute BODY; if an error occurs, return nil.
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3164 Otherwise, return result of last form in BODY."
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3165 `(condition-case nil (progn ,@body) (error nil)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3166
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3167 ;; XEmacs addition
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3168 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3169 (defmacro ignore-file-errors (&rest body)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3170 "Execute FORMS; if an error of type `file-error' occurs, return nil.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3171 Otherwise, return result of last FORM."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3172 `(condition-case nil (progn ,@body) (file-error nil)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3173
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3174
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3175 ;;; Compiler macros.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3176
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3177 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3178 (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
3179 "Define a compiler-only macro.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3180 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
3181 FUNC is compiled (i.e., not interpreted). Compiler macros should be used
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3182 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
3183 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
3184 FUNC, though possibly more efficiently. Note that, like regular macros,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3185 compiler macros are expanded repeatedly until no further expansions are
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3186 possible. Unlike regular macros, BODY can decide to \"punt\" and leave the
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3187 original function call alone by declaring an initial `&whole foo' parameter
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3188 and then returning foo."
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3189 (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
3190 (while (consp p) (push (pop p) res))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3191 (setq args (nconc (nreverse res) (and p (list '&rest p)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3192 (list 'eval-when '(compile load eval)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3193 (cl-transform-function-property
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3194 func 'cl-compiler-macro
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3195 (cons (if (memq '&whole args) (delq '&whole args)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3196 (cons '--cl-whole-arg-- args)) body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3197 (list 'or (list 'get (list 'quote func) '(quote byte-compile))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3198 (list 'put (list 'quote func) '(quote byte-compile)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3199 '(quote cl-byte-compile-compiler-macro)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3200
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3201 ;;;###autoload
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3202 (defun compiler-macroexpand (form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3203 (while
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3204 (let ((func (car-safe form)) (handler nil))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3205 (while (and (symbolp func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3206 (not (setq handler (get func 'cl-compiler-macro)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3207 (fboundp func)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3208 (or (not (eq (car-safe (symbol-function func)) 'autoload))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3209 (load (nth 1 (symbol-function func)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3210 (setq func (symbol-function func)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3211 (and handler
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3212 (not (eq form (setq form (apply handler form (cdr form))))))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3213 form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3214
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3215 (defun cl-byte-compile-compiler-macro (form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3216 (if (eq form (setq form (compiler-macroexpand form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3217 (byte-compile-normal-call form)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3218 (byte-compile-form form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3219
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3220 (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
3221 "Define NAME as a function.
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3222 Like `defun', except the function is automatically declared `inline',
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3223 ARGLIST allows full Common Lisp conventions, and BODY is implicitly
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3224 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
3225 (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
3226 (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
3227 body
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3228 (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
3229 (pbody (cons 'progn exec-body))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3230 (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
3231 (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
3232 (list 'progn
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3233 (if p nil ; give up if defaults refer to earlier args
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3234 (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
3235 (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
3236 (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
3237 (cons '&cl-quote arglist))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3238 (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
3239 (list 'quote (list* 'block name exec-body))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3240 (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
3241 (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
3242 (list* 'defun* name arglist docstring body))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3243
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3244 (defun cl-defsubst-expand (argns body simple whole unsafe &rest argvs)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3245 (if (and whole (not (cl-safe-expr-p (cons 'progn argvs)))) whole
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3246 (if (cl-simple-exprs-p argvs) (setq simple t))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3247 (let ((lets (delq nil
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3248 (mapcar* #'(lambda (argn argv)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3249 (if (or simple (cl-const-expr-p argv))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3250 (progn (setq body (subst argv argn body))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3251 (and unsafe (list argn argv)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3252 (list argn argv)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3253 argns argvs))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3254 (if lets (list 'let lets body) body))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3255
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3256
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3257 ;;; Compile-time optimizations for some functions defined in this package.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3258 ;;; 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
3259 ;;; mainly to make sure these macros will be present.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3260
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3261 (defun cl-non-fixnum-number-p (object)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3262 (and (numberp object) (not (fixnump object))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3263
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3264 (define-compiler-macro eql (&whole form a b)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3265 (cond ((eq (cl-const-expr-p a) t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3266 (let ((val (cl-const-expr-val a)))
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3267 (if (cl-non-fixnum-number-p val)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3268 (list 'equal a b)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3269 (list 'eq a b))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3270 ((eq (cl-const-expr-p b) t)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3271 (let ((val (cl-const-expr-val b)))
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3272 (if (cl-non-fixnum-number-p val)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3273 (list 'equal a b)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3274 (list 'eq a b))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3275 (t form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3276
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3277 (macrolet
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3278 ((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
3279 "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
3280 :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
3281 (list*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3282 'progn
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3283 (mapcar
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3284 (function*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3285 (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
3286 `(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
3287 (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
3288 form
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3289 (condition-case nil
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3290 (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
3291 (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
3292 (list (pop keys))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3293 (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
3294 (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
3295 (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
3296 (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
3297 (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
3298 (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
3299 form
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3300 (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
3301 ((eq test 'equal)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3302 `(,',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
3303 ((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
3304 (not (eq not-constant item-val)))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3305 (if (cl-non-fixnum-number-p item-val)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3306 `(,',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
3307 `(,',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
3308 ((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
3309 list-val)))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3310 (if (some 'cl-non-fixnum-number-p list-val)
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
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 ;; 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
3313 ;; 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
3314 ;; 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
3315 ;; 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
3316 `(,',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
3317 ;; 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
3318 ;; 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
3319 ((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
3320 (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
3321 (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
3322 (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
3323 `(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
3324 (,',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
3325 ,(second test-expr))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3326 (,',star-function
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3327 ,item ,list :test
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3328 ,(third test-expr)))))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3329 (t form)))))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3330 ;; 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
3331 ;; #'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
3332 (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
3333 macros))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3334 (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
3335 (member* memq member)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3336 (assoc* assq assoc)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3337 (rassoc* rassq rassoc)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3338
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3339 (define-compiler-macro adjoin (&whole form a list &rest keys)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3340 (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
3341 (not (memq :key keys)))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3342 (list 'if (list* 'member* a list keys) list (list 'cons a list))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3343 form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3344
5338
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3345 (define-compiler-macro delete (&whole form &rest args)
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3346 (symbol-macrolet
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3347 ((not-constant '#:not-constant))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3348 (let ((cl-const-expr-val (cl-const-expr-val (nth 1 form) not-constant)))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3349 (if (and (cdr form) (not (eq not-constant cl-const-expr-val))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3350 (or (symbolp cl-const-expr-val) (fixnump cl-const-expr-val)
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3351 (characterp cl-const-expr-val)))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3352 (cons 'delete* (cdr form))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3353 `(delete* ,@(cdr form) :test #'equal)))))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3354
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3355 (define-compiler-macro delq (&whole form &rest args)
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3356 (symbol-macrolet
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3357 ((not-constant '#:not-constant))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3358 (let ((cl-const-expr-val (cl-const-expr-val (nth 1 form) not-constant)))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3359 (if (and (cdr form) (not (eq not-constant cl-const-expr-val))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3360 (not (cl-non-fixnum-number-p cl-const-expr-val)))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3361 (cons 'delete* (cdr form))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3362 `(delete* ,@(cdr form) :test #'eq)))))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3363
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3364 (define-compiler-macro remove (&whole form &rest args)
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3365 (symbol-macrolet
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3366 ((not-constant '#:not-constant))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3367 (let ((cl-const-expr-val (cl-const-expr-val (nth 1 form) not-constant)))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3368 (if (and (cdr form) (not (eq not-constant cl-const-expr-val))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3369 (or (symbolp cl-const-expr-val) (fixnump cl-const-expr-val)
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3370 (characterp cl-const-expr-val)))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3371 (cons 'remove* (cdr form))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3372 `(remove* ,@(cdr form) :test #'equal)))))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3373
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3374 (define-compiler-macro remq (&whole form &rest args)
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3375 (symbol-macrolet
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3376 ((not-constant '#:not-constant))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3377 (let ((cl-const-expr-val (cl-const-expr-val (nth 1 form) not-constant)))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3378 (if (and (cdr form) (not (eq not-constant cl-const-expr-val))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3379 (not (cl-non-fixnum-number-p cl-const-expr-val)))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3380 (cons 'remove* (cdr form))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3381 `(remove* ,@(cdr form) :test #'eq)))))
8608eadee6ba Move #'delq, #'delete to Lisp, adding support for sequences.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5329
diff changeset
3382
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3383 (macrolet
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3384 ((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
3385 "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
3386 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
3387 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
3388 (cons
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3389 'progn
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3390 (mapcar
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3391 (function*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3392 (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
3393 (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
3394 "not")
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3395 :if-not
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3396 :if)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3397 `(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
3398 (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
3399 (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
3400 (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
3401 ;; 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
3402 ;; 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
3403 ;; 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
3404 `(,',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
3405 ,(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
3406 form)))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3407 alist))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3408 (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
3409 (remove-if . remove*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3410 (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
3411 (delete-if . delete*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3412 (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
3413 (find-if . find)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3414 (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
3415 (position-if . position)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3416 (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
3417 (count-if . count)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3418 (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
3419 (member-if . member*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3420 (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
3421 (assoc-if . assoc*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3422 (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
3423 (rassoc-if . rassoc*)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3424 (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
3425
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3426 (macrolet
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3427 ((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
3428 "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
3429 (cons
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3430 'progn
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3431 (mapcar
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3432 (function*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3433 (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
3434 (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
3435 "not")
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3436 :if-not
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3437 :if)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3438 `(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
3439 (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
3440 (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
3441 (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
3442 `(,',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
3443 ,,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
3444 form)))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3445 alist))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3446 (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
3447 (substitute-if . substitute)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3448 (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
3449 (nsubstitute-if . nsubstitute)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3450 (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
3451
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3452 (macrolet
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3453 ((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
3454 "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
3455 (cons
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3456 'progn
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3457 (mapcar
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3458 (function*
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3459 (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
3460 (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
3461 "not")
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3462 :if-not
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3463 :if)))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3464 `(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
3465 (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
3466 (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
3467 (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
3468 `(,',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
3469 `'((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
3470 (second form))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3471 `(list (cons ',',function
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3472 ,(second form))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3473 ,(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
3474 ,@(nthcdr 4 form))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3475 form)))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3476 alist))))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3477 (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
3478 (subst-if . sublis)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3479 (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
3480 (nsubst-if . nsublis)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3481 (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
3482
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3483 (define-compiler-macro list* (arg &rest others)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3484 (let* ((args (reverse (cons arg others)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3485 (form (car args)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3486 (while (setq args (cdr args))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3487 (setq form (list 'cons (car args) form)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3488 form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3489
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3490 ;; XEmacs change: our builtin get takes the default argument
440
8de8e3f6228a Import from CVS: tag r21-2-28
cvs
parents: 428
diff changeset
3491 (define-compiler-macro get* (sym prop &optional default)
8de8e3f6228a Import from CVS: tag r21-2-28
cvs
parents: 428
diff changeset
3492 (list 'get sym prop default))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3493
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
3494 (define-compiler-macro getf (sym prop &optional default)
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
3495 (list 'plist-get sym prop default))
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 440
diff changeset
3496
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3497 (define-compiler-macro typep (&whole form val type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3498 (if (cl-const-expr-p type)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3499 (let ((res (cl-make-type-test val (cl-const-expr-val type))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3500 (if (or (memq (cl-expr-contains res val) '(nil 1))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3501 (cl-simple-expr-p val)) res
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3502 (let ((temp (gensym)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3503 (list 'let (list (list temp val)) (subst temp val res)))))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3504 form))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3505
5085
1ee30d3f9dd0 Handle the :from-end argument correctly, #'delete-duplicates compiler macro.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5084
diff changeset
3506 (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
3507 `(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
3508
1ee30d3f9dd0 Handle the :from-end argument correctly, #'delete-duplicates compiler macro.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5084
diff changeset
3509 ;; 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
3510 ;; 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
3511 ;; 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
3512 (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
3513 (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
3514 (if (or
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3515 (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
3516 ;; 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
3517 ;; 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
3518 ;; 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
3519 '(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
3520 (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
3521 ;; 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
3522 (not (cdr form)))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3523 form
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3524 (cond
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3525 ((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
3526 (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
3527 `(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
3528 cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3529 (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
3530 (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
3531 (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
3532 (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
3533 (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
3534 (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
3535 (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
3536 begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3537 ((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
3538 (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
3539 `(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
3540 (cl-seq begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3541 (while cl-seq
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3542 (setq cl-seq (setcdr cl-seq
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3543 (delq (car cl-seq) (cdr cl-seq)))))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3544 begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3545 ((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
3546 (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
3547 `(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
3548 cl-seq)
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3549 (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
3550 (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
3551 (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
3552 (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
3553 (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
3554 (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
3555 (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
3556 begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3557 ((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
3558 (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
3559 `(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
3560 (cl-seq begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3561 (while cl-seq
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3562 (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
3563 (cdr cl-seq)))))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3564 begin))
8aa511adfad6 #'delete-duplicates: don't attempt to compiler macroexpand with bad arguments
Aidan Kehoe <kehoea@parhasard.net>
parents: 5316
diff changeset
3565 (t form)))))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3566
4723
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3567 ;; 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
3568 ;; 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
3569 ;; 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
3570 (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
3571 (if (stringp string)
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3572 (regexp-quote string)
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3573 form))
ebca981a0012 If STRING is constant, call regexp-quote at compile time.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4719
diff changeset
3574
4906
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3575 ;; 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
3576 ;; 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
3577 ;; 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
3578 ;; 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
3579 ;; 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
3580 ;; 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
3581 ;; 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
3582 ;; 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
3583 ;; 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
3584 ;; 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
3585 ;; 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
3586 ;; 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
3587 ;;
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3588 ;; --ben
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3589
4792
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3590 (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
3591 "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
3592
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3593 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
3594 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
3595 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
3596
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3597 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
3598 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
3599 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
3600 ;; 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
3601 ;; 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
3602 ;; 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
3603 (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
3604 (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
3605 (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
3606 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
3607 (macrolet
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3608 ((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
3609 `(prog1
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3610 (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
3611 (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
3612 (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
3613 (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
3614 (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
3615 (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
3616 (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
3617 ;; 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
3618 ;; 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
3619 ;; 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
3620 (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
3621 ;; 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
3622 ;; 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
3623 ;; 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
3624 ;; 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
3625 (cond
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3626 ((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
3627 ;; 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
3628 `(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
3629 (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
3630 ((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
3631 `(,@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
3632 (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
3633 (= ,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
3634 ((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
3635 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
3636 ((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
3637 ;; 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
3638 (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
3639 (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
3640 (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
3641 (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
3642
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3643 ;; 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
3644 ;; 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
3645 ;; 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
3646 ;; 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
3647 ;; 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
3648 ;; 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
3649 ;; 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
3650 ;;((unordered-check
6ef8256a020a implement equalp in C, fix case-folding, add equal() method for keymaps
Ben Wing <ben@xemacs.org>
parents: 4885
diff changeset
3651 ;; ;; 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
3652 ;; ;; 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
3653 ;; ;; 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
3654 ;; (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
3655 ;; (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
3656 ;; ;; 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
3657 ;; (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
3658
4792
95b04754ea8c Make #'equalp more compatible with CL; add a compiler macro, test & doc it.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4783
diff changeset
3659 ;; 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
3660 ;; 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
3661 ;; 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
3662 (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
3663
4997
8800b5350a13 Move #'some, #'every to C, implementing them with mapcarX.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4996
diff changeset
3664 (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
3665 `(not (some ,@(cdr form))))
4997
8800b5350a13 Move #'some, #'every to C, implementing them with mapcarX.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4996
diff changeset
3666
8800b5350a13 Move #'some, #'every to C, implementing them with mapcarX.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4996
diff changeset
3667 (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
3668 `(not (every ,@(cdr form))))
4997
8800b5350a13 Move #'some, #'every to C, implementing them with mapcarX.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4996
diff changeset
3669
5056
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3670 (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
3671 (cond
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3672 ((< (length form) 2)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3673 ;; Error at runtime:
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3674 form)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3675 ((cl-const-exprs-p (cdr form))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3676 `#'(lambda (&rest ignore) (values ,@(cdr form))))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3677 (t
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3678 (let* ((num-values (length (cdr form)))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3679 (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
3680 (placeholders (loop
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3681 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
3682 collect (make-symbol (format "%d" i))))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3683 (compiled
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3684 (byte-compile-sexp
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3685 `#'(lambda (&rest ignore)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3686 ;; 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
3687 ;; constants vector:
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3688 (values ,@(mapcar #'quote-maybe placeholders)))))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3689 position)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3690 `(make-byte-code '(&rest ignore)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3691 ,(compiled-function-instructions compiled)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3692 (vector ,@(loop
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3693 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
3694 collect (if (setq position
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3695 (position constant placeholders))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3696 (prog2
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3697 (incf (aref placeholders-counts position))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3698 (nth position (cdr form)))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3699 (quote-maybe constant))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3700 finally
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3701 (assert (every #'zerop placeholders-counts)
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3702 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
3703 ,(compiled-function-stack-depth compiled))))))
6aba0daedb7c Add #'constantly, as specified by ANSI Common Lisp.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4997
diff changeset
3704
5182
2e528066e2fc Move #'sort*, #'fill, #'merge to C from cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5153
diff changeset
3705 (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
3706 (cons 'sort* (cdr form)))
2e528066e2fc Move #'sort*, #'fill, #'merge to C from cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5153
diff changeset
3707
5219
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3708 (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
3709 (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
3710
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3711 (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
3712 `(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
3713
2d0937dc83cf Tidying of CL files; make docstrings read better, remove commented-out code
Aidan Kehoe <kehoea@parhasard.net>
parents: 5182
diff changeset
3714 (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
3715 `(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
3716
5226
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3717 (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
3718 (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
3719 (cond
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3720 ((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
3721 (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
3722 ((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
3723 (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
3724 (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
3725 (cfa (compiled-function-arglist cf))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3726 (do-apply (memq '&rest cfa)))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3727 `#'(lambda ,cfa
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3728 (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
3729 ,@(remq '&optional
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3730 (remq '&rest cfa)))))))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3731 (t
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3732 `#'(lambda (&rest arguments)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3733 (not (apply ,fn arguments)))))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3734 ;; 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
3735 (destructuring-bind
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3736 (arglist instructions constants stack-depth)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3737 (let ((compiled-lambda
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3738 (byte-compile-sexp
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3739 #'(lambda (&rest arguments)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3740 (not (apply 'placeholder arguments))))))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3741 (list
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3742 (compiled-function-arglist compiled-lambda)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3743 (compiled-function-instructions compiled-lambda)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3744 (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
3745 (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
3746 `(make-byte-code
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3747 ',arglist ,instructions (vector
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3748 ,@(nsublis
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3749 (list (cons (quote-maybe
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3750 'placeholder)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3751 fn))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3752 (mapcar #'quote-maybe constants)
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3753 :test #'equal))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3754 ,stack-depth))))
7789ae555c45 Add Common Lisp's #'complement to cl-extra.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5219
diff changeset
3755
5242
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3756 (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
3757 (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
3758 '(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
3759 (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
3760 (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
3761 (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
3762 (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
3763 (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
3764 form))
f3eca926258e Bit vectors are also sequences; enforce this in some CL functions.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5226
diff changeset
3765
5294
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3766 (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
3767 string &optional inplace)
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3768 (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
3769 `(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
3770 (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
3771 form))
bbff29a01820 Add compiler macros and compilation sanity-checks for functions with keywords.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5285
diff changeset
3772
5329
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3773 (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
3774 (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
3775 (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
3776 form))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3777
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3778 (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
3779 (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
3780 (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
3781 form))
7b391d07b334 Tweak a few compiler macros for functions in cl-seq.el.
Aidan Kehoe <kehoea@parhasard.net>
parents: 5326
diff changeset
3782
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
3783 (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
3784 #'(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
3785 ;; 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
3786 ;; 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
3787 ;; 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
3788 ;; 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
3789 (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
3790 #'(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
3791 (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
3792 (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
3793 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
3794 (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
3795 #'(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
3796 (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
3797 `((,(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
3798 ,(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
3799 (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
3800 '(= < > <= >=))
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
3801
5313
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3802 ;; 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
3803 ;; 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
3804 (macrolet
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3805 ((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
3806 (cons
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3807 'progn
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3808 (loop
5ed261fd2bd9 Unrool a load-time loop at macro expansion time, cl-macs.el
Aidan Kehoe <kehoea@parhasard.net>
parents: 5305
diff changeset
3809 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
3810 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
3811 (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
3812 ,(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
3813 (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
3814 `(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
3815 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
3816 (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
3817 (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
3818 (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
3819 (fifth 'nth 4 x) (sixth 'nth 5 x) (seventh 'nth 6 x)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3820 (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
3821 (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
3822 (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
3823 (evenp 'eql (list 'logand x 1) 0)
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3824 (caar car car) (cadr car cdr) (cdar cdr car) (cddr cdr cdr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3825 (caaar car caar) (caadr car cadr) (cadar car cdar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3826 (caddr car cddr) (cdaar cdr caar) (cdadr cdr cadr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3827 (cddar cdr cdar) (cdddr cdr cddr) (caaaar car caaar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3828 (caaadr car caadr) (caadar car cadar) (caaddr car caddr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3829 (cadaar car cdaar) (cadadr car cdadr) (caddar car cddar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3830 (cadddr car cdddr) (cdaaar cdr caaar) (cdaadr cdr caadr)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3831 (cdadar cdr cadar) (cdaddr cdr caddr) (cddaar cdr cdaar)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3832 (cddadr cdr cdadr) (cdddar cdr cddar) (cddddr cdr cdddr)))
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3833
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3834 ;;; Things that are inline.
4997
8800b5350a13 Move #'some, #'every to C, implementing them with mapcarX.
Aidan Kehoe <kehoea@parhasard.net>
parents: 4996
diff changeset
3835 (proclaim '(inline acons map concatenate
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3836 ;; XEmacs omission: gethash is builtin
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3837 cl-set-elt revappend nreconc))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3838
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3839 ;;; Things that are side-effect-free. Moved to byte-optimize.el
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3840 ;(mapcar (function (lambda (x) (put x 'side-effect-free t)))
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3841 ; '(oddp evenp signum last butlast ldiff pairlis gcd lcm
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3842 ; isqrt floor* ceiling* truncate* round* mod* rem* subseq
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3843 ; list-length get* getf))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3844
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3845 ;;; Things that are side-effect-and-error-free. Moved to byte-optimize.el
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3846 ;(mapcar (function (lambda (x) (put x 'side-effect-free 'error-free)))
4885
6772ce4d982b Fix hash tables, #'member*, #'assoc*, #'eql compiler macros if bignums
Aidan Kehoe <kehoea@parhasard.net>
parents: 4820
diff changeset
3847 ; '(eql list* subst acons equalp random-state-p
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3848 ; copy-tree sublis))
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3849
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3850
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3851 (run-hooks 'cl-macs-load-hook)
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3852
2153
393039450288 [xemacs-hg @ 2004-06-26 21:25:23 by james]
james
parents: 1580
diff changeset
3853 ;;; arch-tag: afd947a6-b553-4df1-bba5-000be6388f46
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3854 ;;; cl-macs.el ends here