Mercurial > emacs
annotate lisp/emacs-lisp/cl.el @ 94953:80d92e1da986
(set-language-environment): Set current-iso639-language
author | Kenichi Handa <handa@m17n.org> |
---|---|
date | Wed, 14 May 2008 01:55:06 +0000 |
parents | 0b1b2b6fee44 |
children | ceb7b0d5c55f |
rev | line source |
---|---|
85736
e5bd859d65dd
Move local variables to end of file, and set byte-compile-warnings to
Glenn Morris <rgm@gnu.org>
parents:
82140
diff
changeset
|
1 ;;; cl.el --- Common Lisp extensions for Emacs |
4355 | 2 |
74466 | 3 ;; Copyright (C) 1993, 2001, 2002, 2003, 2004, 2005, |
79704 | 4 ;; 2006, 2007, 2008 Free Software Foundation, Inc. |
4355 | 5 |
6 ;; Author: Dave Gillespie <daveg@synaptics.com> | |
7 ;; Version: 2.02 | |
8 ;; Keywords: extensions | |
9 | |
10 ;; This file is part of GNU Emacs. | |
11 | |
94655
90a2847062be
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
87649
diff
changeset
|
12 ;; GNU Emacs is free software: you can redistribute it and/or modify |
4355 | 13 ;; it under the terms of the GNU General Public License as published by |
94655
90a2847062be
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
87649
diff
changeset
|
14 ;; the Free Software Foundation, either version 3 of the License, or |
90a2847062be
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
87649
diff
changeset
|
15 ;; (at your option) any later version. |
4355 | 16 |
17 ;; GNU Emacs is distributed in the hope that it will be useful, | |
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
20 ;; GNU General Public License for more details. | |
21 | |
22 ;; You should have received a copy of the GNU General Public License | |
94655
90a2847062be
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
87649
diff
changeset
|
23 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
4355 | 24 |
7942 | 25 ;;; Commentary: |
4355 | 26 |
27 ;; These are extensions to Emacs Lisp that provide a degree of | |
28 ;; Common Lisp compatibility, beyond what is already built-in | |
29 ;; in Emacs Lisp. | |
30 ;; | |
31 ;; This package was written by Dave Gillespie; it is a complete | |
32 ;; rewrite of Cesar Quiroz's original cl.el package of December 1986. | |
33 ;; | |
34 ;; Bug reports, comments, and suggestions are welcome! | |
35 | |
36 ;; This file contains the portions of the Common Lisp extensions | |
37 ;; package which should always be present. | |
38 | |
39 | |
7942 | 40 ;;; Future notes: |
4355 | 41 |
42 ;; Once Emacs 19 becomes standard, many things in this package which are | |
43 ;; messy for reasons of compatibility can be greatly simplified. For now, | |
44 ;; I prefer to maintain one unified version. | |
45 | |
46 | |
7942 | 47 ;;; Change Log: |
4355 | 48 |
49 ;; Version 2.02 (30 Jul 93): | |
50 ;; * Added "cl-compat.el" file, extra compatibility with old package. | |
51 ;; * Added `lexical-let' and `lexical-let*'. | |
52 ;; * Added `define-modify-macro', `callf', and `callf2'. | |
53 ;; * Added `ignore-errors'. | |
54 ;; * Changed `(setf (nthcdr N PLACE) X)' to work when N is zero. | |
55 ;; * Merged `*gentemp-counter*' into `*gensym-counter*'. | |
56 ;; * Extended `subseq' to allow negative START and END like `substring'. | |
57 ;; * Added `in-ref', `across-ref', `elements of-ref' loop clauses. | |
58 ;; * Added `concat', `vconcat' loop clauses. | |
59 ;; * Cleaned up a number of compiler warnings. | |
60 | |
61 ;; Version 2.01 (7 Jul 93): | |
62 ;; * Added support for FSF version of Emacs 19. | |
63 ;; * Added `add-hook' for Emacs 18 users. | |
64 ;; * Added `defsubst*' and `symbol-macrolet'. | |
65 ;; * Added `maplist', `mapc', `mapl', `mapcan', `mapcon'. | |
66 ;; * Added `map', `concatenate', `reduce', `merge'. | |
67 ;; * Added `revappend', `nreconc', `tailp', `tree-equal'. | |
68 ;; * Added `assert', `check-type', `typecase', `typep', and `deftype'. | |
69 ;; * Added destructuring and `&environment' support to `defmacro*'. | |
70 ;; * Added destructuring to `loop', and added the following clauses: | |
71 ;; `elements', `frames', `overlays', `intervals', `buffers', `key-seqs'. | |
72 ;; * Renamed `delete' to `delete*' and `remove' to `remove*'. | |
73 ;; * Completed support for all keywords in `remove*', `substitute', etc. | |
74 ;; * Added `most-positive-float' and company. | |
75 ;; * Fixed hash tables to work with latest Lucid Emacs. | |
76 ;; * `proclaim' forms are no longer compile-time-evaluating; use `declaim'. | |
77 ;; * Syntax for `warn' declarations has changed. | |
78 ;; * Improved implementation of `random*'. | |
79 ;; * Moved most sequence functions to a new file, cl-seq.el. | |
80 ;; * Moved `eval-when' into cl-macs.el. | |
81 ;; * Moved `pushnew' and `adjoin' to cl.el for most common cases. | |
82 ;; * Moved `provide' forms down to ends of files. | |
83 ;; * Changed expansion of `pop' to something that compiles to better code. | |
84 ;; * Changed so that no patch is required for Emacs 19 byte compiler. | |
85 ;; * Made more things dependent on `optimize' declarations. | |
86 ;; * Added a partial implementation of struct print functions. | |
87 ;; * Miscellaneous minor changes. | |
88 | |
89 ;; Version 2.00: | |
90 ;; * First public release of this package. | |
91 | |
92 | |
7942 | 93 ;;; Code: |
4355 | 94 |
95 (defvar cl-optimize-speed 1) | |
96 (defvar cl-optimize-safety 1) | |
97 | |
98 | |
24790
a6b268f4dfc7
(custom-print-functions): Add autoload cookie.
Karl Heuer <kwzh@gnu.org>
parents:
21465
diff
changeset
|
99 ;;;###autoload |
4355 | 100 (defvar custom-print-functions nil |
101 "This is a list of functions that format user objects for printing. | |
102 Each function is called in turn with three arguments: the object, the | |
103 stream, and the print level (currently ignored). If it is able to | |
104 print the object it returns true; otherwise it returns nil and the | |
105 printer proceeds to the next function on the list. | |
106 | |
107 This variable is not used at present, but it is defined in hopes that | |
108 a future Emacs interpreter will be able to use it.") | |
109 | |
85834
7400d979a9d9
(cl-cannot-unload): Remove function.
Juanma Barranquero <lekktu@gmail.com>
parents:
85736
diff
changeset
|
110 (defun cl-unload-function () |
7400d979a9d9
(cl-cannot-unload): Remove function.
Juanma Barranquero <lekktu@gmail.com>
parents:
85736
diff
changeset
|
111 "Stop unloading of the Common Lisp extensions." |
7400d979a9d9
(cl-cannot-unload): Remove function.
Juanma Barranquero <lekktu@gmail.com>
parents:
85736
diff
changeset
|
112 (message "Cannot unload the feature `cl'") |
7400d979a9d9
(cl-cannot-unload): Remove function.
Juanma Barranquero <lekktu@gmail.com>
parents:
85736
diff
changeset
|
113 ;; stop standard unloading! |
7400d979a9d9
(cl-cannot-unload): Remove function.
Juanma Barranquero <lekktu@gmail.com>
parents:
85736
diff
changeset
|
114 t) |
4355 | 115 |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
116 ;;; Generalized variables. |
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
117 ;; These macros are defined here so that they |
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
118 ;; can safely be used in .emacs files. |
4355 | 119 |
120 (defmacro incf (place &optional x) | |
28824
add63b27c709
Doc fixes; mainly avoid duplicating arg
Dave Love <fx@gnu.org>
parents:
28038
diff
changeset
|
121 "Increment PLACE by X (1 by default). |
4355 | 122 PLACE may be a symbol, or any generalized variable allowed by `setf'. |
123 The return value is the incremented value of PLACE." | |
124 (if (symbolp place) | |
125 (list 'setq place (if x (list '+ place x) (list '1+ place))) | |
126 (list 'callf '+ place (or x 1)))) | |
127 | |
128 (defmacro decf (place &optional x) | |
28824
add63b27c709
Doc fixes; mainly avoid duplicating arg
Dave Love <fx@gnu.org>
parents:
28038
diff
changeset
|
129 "Decrement PLACE by X (1 by default). |
4355 | 130 PLACE may be a symbol, or any generalized variable allowed by `setf'. |
131 The return value is the decremented value of PLACE." | |
132 (if (symbolp place) | |
133 (list 'setq place (if x (list '- place x) (list '1- place))) | |
134 (list 'callf '- place (or x 1)))) | |
135 | |
136 (defmacro pop (place) | |
28824
add63b27c709
Doc fixes; mainly avoid duplicating arg
Dave Love <fx@gnu.org>
parents:
28038
diff
changeset
|
137 "Remove and return the head of the list stored in PLACE. |
4355 | 138 Analogous to (prog1 (car PLACE) (setf PLACE (cdr PLACE))), though more |
139 careful about evaluating each argument only once and in the right order. | |
140 PLACE may be a symbol, or any generalized variable allowed by `setf'." | |
141 (if (symbolp place) | |
142 (list 'car (list 'prog1 place (list 'setq place (list 'cdr place)))) | |
143 (cl-do-pop place))) | |
144 | |
145 (defmacro push (x place) | |
28824
add63b27c709
Doc fixes; mainly avoid duplicating arg
Dave Love <fx@gnu.org>
parents:
28038
diff
changeset
|
146 "Insert X at the head of the list stored in PLACE. |
4355 | 147 Analogous to (setf PLACE (cons X PLACE)), though more careful about |
148 evaluating each argument only once and in the right order. PLACE may | |
149 be a symbol, or any generalized variable allowed by `setf'." | |
150 (if (symbolp place) (list 'setq place (list 'cons x place)) | |
151 (list 'callf2 'cons x place))) | |
152 | |
153 (defmacro pushnew (x place &rest keys) | |
154 "(pushnew X PLACE): insert X at the head of the list if not already there. | |
155 Like (push X PLACE), except that the list is unmodified if X is `eql' to | |
156 an element already on the list. | |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
157 \nKeywords supported: :test :test-not :key |
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
158 \n(fn X PLACE [KEYWORD VALUE]...)" |
72785
a384943e84d7
(pushnew): Use add-to-list when convenient.
Richard M. Stallman <rms@gnu.org>
parents:
68648
diff
changeset
|
159 (if (symbolp place) |
a384943e84d7
(pushnew): Use add-to-list when convenient.
Richard M. Stallman <rms@gnu.org>
parents:
68648
diff
changeset
|
160 (if (null keys) |
73227
79c3587798b4
(pushnew-internal): Remove defvar.
Kim F. Storm <storm@cua.dk>
parents:
73030
diff
changeset
|
161 `(let ((x ,x)) |
79c3587798b4
(pushnew-internal): Remove defvar.
Kim F. Storm <storm@cua.dk>
parents:
73030
diff
changeset
|
162 (if (memql x ,place) ,place (setq ,place (cons x ,place)))) |
72785
a384943e84d7
(pushnew): Use add-to-list when convenient.
Richard M. Stallman <rms@gnu.org>
parents:
68648
diff
changeset
|
163 (list 'setq place (list* 'adjoin x place keys))) |
4355 | 164 (list* 'callf2 'adjoin x place keys))) |
165 | |
166 (defun cl-set-elt (seq n val) | |
167 (if (listp seq) (setcar (nthcdr n seq) val) (aset seq n val))) | |
168 | |
94877
0b1b2b6fee44
(cl-set-nthcdr): Make it a defsubst so that
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
94655
diff
changeset
|
169 (defsubst cl-set-nthcdr (n list x) |
4355 | 170 (if (<= n 0) x (setcdr (nthcdr (1- n) list) x) list)) |
171 | |
172 (defun cl-set-buffer-substring (start end val) | |
173 (save-excursion (delete-region start end) | |
174 (goto-char start) | |
175 (insert val) | |
176 val)) | |
177 | |
178 (defun cl-set-substring (str start end val) | |
179 (if end (if (< end 0) (incf end (length str))) | |
180 (setq end (length str))) | |
46356
35f0290a4079
(cl-set-substring): Fix thinko.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46325
diff
changeset
|
181 (if (< start 0) (incf start (length str))) |
4355 | 182 (concat (and (> start 0) (substring str 0 start)) |
183 val | |
184 (and (< end (length str)) (substring str end)))) | |
185 | |
186 | |
187 ;;; Control structures. | |
188 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
189 ;; These macros are so simple and so often-used that it's better to have |
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
190 ;; them all the time than to load them from cl-macs.el. |
4355 | 191 |
192 (defun cl-map-extents (&rest cl-args) | |
26939
672e75118c0f
Remove Emacs 18 compatibility code. Prepend `cl-' to autoload names
Dave Love <fx@gnu.org>
parents:
24790
diff
changeset
|
193 (apply 'cl-map-overlays cl-args)) |
4355 | 194 |
195 | |
196 ;;; Blocks and exits. | |
197 | |
198 (defalias 'cl-block-wrapper 'identity) | |
199 (defalias 'cl-block-throw 'throw) | |
200 | |
201 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
202 ;;; Multiple values. |
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
203 ;; True multiple values are not supported, or even |
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
204 ;; simulated. Instead, multiple-value-bind and friends simply expect |
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
205 ;; the target form to return the values as a list. |
4355 | 206 |
41109
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
207 (defsubst values (&rest values) |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
208 "Return multiple values, Common Lisp style. |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
209 The arguments of `values' are the values |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
210 that the containing function should return." |
46027
38072df535c8
(values): Simplify definition.
Richard M. Stallman <rms@gnu.org>
parents:
45739
diff
changeset
|
211 values) |
41109
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
212 |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
213 (defsubst values-list (list) |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
214 "Return multiple values, Common Lisp style, taken from a list. |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
215 LIST specifies the list of values |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
216 that the containing function should return." |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
217 list) |
4355 | 218 |
41109
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
219 (defsubst multiple-value-list (expression) |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
220 "Return a list of the multiple values produced by EXPRESSION. |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
221 This handles multiple values in Common Lisp style, but it does not |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
222 work right when EXPRESSION calls an ordinary Emacs Lisp function |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
223 that returns just one value." |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
224 expression) |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
225 |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
226 (defsubst multiple-value-apply (function expression) |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
227 "Evaluate EXPRESSION to get multiple values and apply FUNCTION to them. |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
228 This handles multiple values in Common Lisp style, but it does not work |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
229 right when EXPRESSION calls an ordinary Emacs Lisp function that returns just |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
230 one value." |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
231 (apply function expression)) |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
232 |
48462
b9d1a3c5291e
(multiple-value-call): Add docstring.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46356
diff
changeset
|
233 (defalias 'multiple-value-call 'apply |
b9d1a3c5291e
(multiple-value-call): Add docstring.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46356
diff
changeset
|
234 "Apply FUNCTION to ARGUMENTS, taking multiple values into account. |
b9d1a3c5291e
(multiple-value-call): Add docstring.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46356
diff
changeset
|
235 This implementation only handles the case where there is only one argument.") |
46325
606fc43dc51e
(multiple-value-call): Add alias.
Richard M. Stallman <rms@gnu.org>
parents:
46027
diff
changeset
|
236 |
41109
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
237 (defsubst nth-value (n expression) |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
238 "Evaluate EXPRESSION to get multiple values and return the Nth one. |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
239 This handles multiple values in Common Lisp style, but it does not work |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
240 right when EXPRESSION calls an ordinary Emacs Lisp function that returns just |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
241 one value." |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
242 (nth n expression)) |
4355 | 243 |
244 ;;; Macros. | |
245 | |
246 (defvar cl-macro-environment nil) | |
247 (defvar cl-old-macroexpand (prog1 (symbol-function 'macroexpand) | |
248 (defalias 'macroexpand 'cl-macroexpand))) | |
249 | |
250 (defun cl-macroexpand (cl-macro &optional cl-env) | |
9769
6a9124f418db
(cl-macroexpand): keep documentation from `macroexpand'.
Richard M. Stallman <rms@gnu.org>
parents:
7942
diff
changeset
|
251 "Return result of expanding macros at top level of FORM. |
6a9124f418db
(cl-macroexpand): keep documentation from `macroexpand'.
Richard M. Stallman <rms@gnu.org>
parents:
7942
diff
changeset
|
252 If FORM is not a macro call, it is returned unchanged. |
6a9124f418db
(cl-macroexpand): keep documentation from `macroexpand'.
Richard M. Stallman <rms@gnu.org>
parents:
7942
diff
changeset
|
253 Otherwise, the macro is expanded and the expansion is considered |
6a9124f418db
(cl-macroexpand): keep documentation from `macroexpand'.
Richard M. Stallman <rms@gnu.org>
parents:
7942
diff
changeset
|
254 in place of FORM. When a non-macro-call results, it is returned. |
6a9124f418db
(cl-macroexpand): keep documentation from `macroexpand'.
Richard M. Stallman <rms@gnu.org>
parents:
7942
diff
changeset
|
255 |
30998 | 256 The second optional arg ENVIRONMENT specifies an environment of macro |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
257 definitions to shadow the loaded ones for use in file byte-compilation. |
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
258 \n(fn FORM &optional ENVIRONMENT)" |
4355 | 259 (let ((cl-macro-environment cl-env)) |
260 (while (progn (setq cl-macro (funcall cl-old-macroexpand cl-macro cl-env)) | |
261 (and (symbolp cl-macro) | |
262 (cdr (assq (symbol-name cl-macro) cl-env)))) | |
263 (setq cl-macro (cadr (assq (symbol-name cl-macro) cl-env)))) | |
264 cl-macro)) | |
265 | |
266 | |
267 ;;; Declarations. | |
268 | |
269 (defvar cl-compiling-file nil) | |
270 (defun cl-compiling-file () | |
271 (or cl-compiling-file | |
272 (and (boundp 'outbuffer) (bufferp (symbol-value 'outbuffer)) | |
273 (equal (buffer-name (symbol-value 'outbuffer)) | |
274 " *Compiler Output*")))) | |
275 | |
276 (defvar cl-proclaims-deferred nil) | |
277 | |
278 (defun proclaim (spec) | |
279 (if (fboundp 'cl-do-proclaim) (cl-do-proclaim spec t) | |
280 (push spec cl-proclaims-deferred)) | |
281 nil) | |
282 | |
283 (defmacro declaim (&rest specs) | |
284 (let ((body (mapcar (function (lambda (x) (list 'proclaim (list 'quote x)))) | |
285 specs))) | |
286 (if (cl-compiling-file) (list* 'eval-when '(compile load eval) body) | |
287 (cons 'progn body)))) ; avoid loading cl-macs.el for eval-when | |
288 | |
289 | |
290 ;;; Symbols. | |
291 | |
292 (defun cl-random-time () | |
293 (let* ((time (copy-sequence (current-time-string))) (i (length time)) (v 0)) | |
294 (while (>= (decf i) 0) (setq v (+ (* v 3) (aref time i)))) | |
295 v)) | |
296 | |
297 (defvar *gensym-counter* (* (logand (cl-random-time) 1023) 100)) | |
298 | |
299 | |
300 ;;; Numbers. | |
301 | |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
302 (defun floatp-safe (object) |
62424
ecbd5b866b1d
(eql, floatp-safe, plusp, minusp, oddp, evenp, list*): Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
parents:
57519
diff
changeset
|
303 "Return t if OBJECT is a floating point number. |
4355 | 304 On Emacs versions that lack floating-point support, this function |
305 always returns nil." | |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
306 (and (numberp object) (not (integerp object)))) |
4355 | 307 |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
308 (defun plusp (number) |
62424
ecbd5b866b1d
(eql, floatp-safe, plusp, minusp, oddp, evenp, list*): Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
parents:
57519
diff
changeset
|
309 "Return t if NUMBER is positive." |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
310 (> number 0)) |
4355 | 311 |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
312 (defun minusp (number) |
62424
ecbd5b866b1d
(eql, floatp-safe, plusp, minusp, oddp, evenp, list*): Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
parents:
57519
diff
changeset
|
313 "Return t if NUMBER is negative." |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
314 (< number 0)) |
4355 | 315 |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
316 (defun oddp (integer) |
62424
ecbd5b866b1d
(eql, floatp-safe, plusp, minusp, oddp, evenp, list*): Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
parents:
57519
diff
changeset
|
317 "Return t if INTEGER is odd." |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
318 (eq (logand integer 1) 1)) |
4355 | 319 |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
320 (defun evenp (integer) |
62424
ecbd5b866b1d
(eql, floatp-safe, plusp, minusp, oddp, evenp, list*): Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
parents:
57519
diff
changeset
|
321 "Return t if INTEGER is even." |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
322 (eq (logand integer 1) 0)) |
4355 | 323 |
324 (defvar *random-state* (vector 'cl-random-state-tag -1 30 (cl-random-time))) | |
325 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
326 ;; The following are actually set by cl-float-limits. |
4355 | 327 (defconst most-positive-float nil) |
328 (defconst most-negative-float nil) | |
329 (defconst least-positive-float nil) | |
330 (defconst least-negative-float nil) | |
331 (defconst least-positive-normalized-float nil) | |
332 (defconst least-negative-normalized-float nil) | |
333 (defconst float-epsilon nil) | |
334 (defconst float-negative-epsilon nil) | |
335 | |
336 | |
337 ;;; Sequence functions. | |
338 | |
339 (defalias 'copy-seq 'copy-sequence) | |
340 | |
341 (defun mapcar* (cl-func cl-x &rest cl-rest) | |
342 "Apply FUNCTION to each element of SEQ, and make a list of the results. | |
343 If there are several SEQs, FUNCTION is called with that many arguments, | |
344 and mapping stops as soon as the shortest list runs out. With just one | |
345 SEQ, this is like `mapcar'. With several, it is like the Common Lisp | |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
346 `mapcar' function extended to arbitrary sequence types. |
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
347 \n(fn FUNCTION SEQ...)" |
4355 | 348 (if cl-rest |
349 (if (or (cdr cl-rest) (nlistp cl-x) (nlistp (car cl-rest))) | |
350 (cl-mapcar-many cl-func (cons cl-x cl-rest)) | |
351 (let ((cl-res nil) (cl-y (car cl-rest))) | |
352 (while (and cl-x cl-y) | |
353 (push (funcall cl-func (pop cl-x) (pop cl-y)) cl-res)) | |
354 (nreverse cl-res))) | |
355 (mapcar cl-func cl-x))) | |
356 | |
41776
2682c3f36a6a
(svref): New alias.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
41109
diff
changeset
|
357 (defalias 'svref 'aref) |
4355 | 358 |
359 ;;; List functions. | |
360 | |
361 (defalias 'first 'car) | |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
362 (defalias 'second 'cadr) |
4355 | 363 (defalias 'rest 'cdr) |
364 (defalias 'endp 'null) | |
365 | |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
366 (defun third (x) |
34027
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
367 "Return the third element of the list X." |
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
368 (car (cdr (cdr x)))) |
4355 | 369 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
370 (defun fourth (x) |
34027
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
371 "Return the fourth element of the list X." |
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
372 (nth 3 x)) |
4355 | 373 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
374 (defun fifth (x) |
34027
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
375 "Return the fifth element of the list X." |
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
376 (nth 4 x)) |
4355 | 377 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
378 (defun sixth (x) |
34027
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
379 "Return the sixth element of the list X." |
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
380 (nth 5 x)) |
4355 | 381 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
382 (defun seventh (x) |
34027
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
383 "Return the seventh element of the list X." |
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
384 (nth 6 x)) |
4355 | 385 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
386 (defun eighth (x) |
34027
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
387 "Return the eighth element of the list X." |
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
388 (nth 7 x)) |
4355 | 389 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
390 (defun ninth (x) |
34027
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
391 "Return the ninth element of the list X." |
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
392 (nth 8 x)) |
4355 | 393 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
394 (defun tenth (x) |
34027
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
395 "Return the tenth element of the list X." |
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
396 (nth 9 x)) |
4355 | 397 |
398 (defun caaar (x) | |
399 "Return the `car' of the `car' of the `car' of X." | |
400 (car (car (car x)))) | |
401 | |
402 (defun caadr (x) | |
403 "Return the `car' of the `car' of the `cdr' of X." | |
404 (car (car (cdr x)))) | |
405 | |
406 (defun cadar (x) | |
407 "Return the `car' of the `cdr' of the `car' of X." | |
408 (car (cdr (car x)))) | |
409 | |
410 (defun caddr (x) | |
411 "Return the `car' of the `cdr' of the `cdr' of X." | |
412 (car (cdr (cdr x)))) | |
413 | |
414 (defun cdaar (x) | |
415 "Return the `cdr' of the `car' of the `car' of X." | |
416 (cdr (car (car x)))) | |
417 | |
418 (defun cdadr (x) | |
419 "Return the `cdr' of the `car' of the `cdr' of X." | |
420 (cdr (car (cdr x)))) | |
421 | |
422 (defun cddar (x) | |
423 "Return the `cdr' of the `cdr' of the `car' of X." | |
424 (cdr (cdr (car x)))) | |
425 | |
426 (defun cdddr (x) | |
427 "Return the `cdr' of the `cdr' of the `cdr' of X." | |
428 (cdr (cdr (cdr x)))) | |
429 | |
430 (defun caaaar (x) | |
431 "Return the `car' of the `car' of the `car' of the `car' of X." | |
432 (car (car (car (car x))))) | |
433 | |
434 (defun caaadr (x) | |
435 "Return the `car' of the `car' of the `car' of the `cdr' of X." | |
436 (car (car (car (cdr x))))) | |
437 | |
438 (defun caadar (x) | |
439 "Return the `car' of the `car' of the `cdr' of the `car' of X." | |
440 (car (car (cdr (car x))))) | |
441 | |
442 (defun caaddr (x) | |
443 "Return the `car' of the `car' of the `cdr' of the `cdr' of X." | |
444 (car (car (cdr (cdr x))))) | |
445 | |
446 (defun cadaar (x) | |
447 "Return the `car' of the `cdr' of the `car' of the `car' of X." | |
448 (car (cdr (car (car x))))) | |
449 | |
450 (defun cadadr (x) | |
451 "Return the `car' of the `cdr' of the `car' of the `cdr' of X." | |
452 (car (cdr (car (cdr x))))) | |
453 | |
454 (defun caddar (x) | |
455 "Return the `car' of the `cdr' of the `cdr' of the `car' of X." | |
456 (car (cdr (cdr (car x))))) | |
457 | |
458 (defun cadddr (x) | |
459 "Return the `car' of the `cdr' of the `cdr' of the `cdr' of X." | |
460 (car (cdr (cdr (cdr x))))) | |
461 | |
462 (defun cdaaar (x) | |
463 "Return the `cdr' of the `car' of the `car' of the `car' of X." | |
464 (cdr (car (car (car x))))) | |
465 | |
466 (defun cdaadr (x) | |
467 "Return the `cdr' of the `car' of the `car' of the `cdr' of X." | |
468 (cdr (car (car (cdr x))))) | |
469 | |
470 (defun cdadar (x) | |
471 "Return the `cdr' of the `car' of the `cdr' of the `car' of X." | |
472 (cdr (car (cdr (car x))))) | |
473 | |
474 (defun cdaddr (x) | |
475 "Return the `cdr' of the `car' of the `cdr' of the `cdr' of X." | |
476 (cdr (car (cdr (cdr x))))) | |
477 | |
478 (defun cddaar (x) | |
479 "Return the `cdr' of the `cdr' of the `car' of the `car' of X." | |
480 (cdr (cdr (car (car x))))) | |
481 | |
482 (defun cddadr (x) | |
483 "Return the `cdr' of the `cdr' of the `car' of the `cdr' of X." | |
484 (cdr (cdr (car (cdr x))))) | |
485 | |
486 (defun cdddar (x) | |
487 "Return the `cdr' of the `cdr' of the `cdr' of the `car' of X." | |
488 (cdr (cdr (cdr (car x))))) | |
489 | |
490 (defun cddddr (x) | |
491 "Return the `cdr' of the `cdr' of the `cdr' of the `cdr' of X." | |
492 (cdr (cdr (cdr (cdr x))))) | |
493 | |
19585
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
494 ;;(defun last* (x &optional n) |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
495 ;; "Returns the last link in the list LIST. |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
496 ;;With optional argument N, returns Nth-to-last link (default 1)." |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
497 ;; (if n |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
498 ;; (let ((m 0) (p x)) |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
499 ;; (while (consp p) (incf m) (pop p)) |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
500 ;; (if (<= n 0) p |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
501 ;; (if (< n m) (nthcdr (- m n) x) x))) |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
502 ;; (while (consp (cdr x)) (pop x)) |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
503 ;; x)) |
4355 | 504 |
505 (defun list* (arg &rest rest) ; See compiler macro in cl-macs.el | |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
506 "Return a new list with specified ARGs as elements, consed to last ARG. |
4355 | 507 Thus, `(list* A B C D)' is equivalent to `(nconc (list A B C) D)', or to |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
508 `(cons A (cons B (cons C D)))'. |
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
509 \n(fn ARG...)" |
4355 | 510 (cond ((not rest) arg) |
511 ((not (cdr rest)) (cons arg (car rest))) | |
512 (t (let* ((n (length rest)) | |
513 (copy (copy-sequence rest)) | |
514 (last (nthcdr (- n 2) copy))) | |
515 (setcdr last (car (cdr last))) | |
516 (cons arg copy))))) | |
517 | |
518 (defun ldiff (list sublist) | |
519 "Return a copy of LIST with the tail SUBLIST removed." | |
520 (let ((res nil)) | |
521 (while (and (consp list) (not (eq list sublist))) | |
522 (push (pop list) res)) | |
523 (nreverse res))) | |
524 | |
45739
af30a5644ebc
(copy-list): Moved back from subr.el.
Richard M. Stallman <rms@gnu.org>
parents:
45695
diff
changeset
|
525 (defun copy-list (list) |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
526 "Return a copy of LIST, which may be a dotted list. |
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
527 The elements of LIST are not copied, just the list structure itself." |
45739
af30a5644ebc
(copy-list): Moved back from subr.el.
Richard M. Stallman <rms@gnu.org>
parents:
45695
diff
changeset
|
528 (if (consp list) |
af30a5644ebc
(copy-list): Moved back from subr.el.
Richard M. Stallman <rms@gnu.org>
parents:
45695
diff
changeset
|
529 (let ((res nil)) |
af30a5644ebc
(copy-list): Moved back from subr.el.
Richard M. Stallman <rms@gnu.org>
parents:
45695
diff
changeset
|
530 (while (consp list) (push (pop list) res)) |
af30a5644ebc
(copy-list): Moved back from subr.el.
Richard M. Stallman <rms@gnu.org>
parents:
45695
diff
changeset
|
531 (prog1 (nreverse res) (setcdr res list))) |
af30a5644ebc
(copy-list): Moved back from subr.el.
Richard M. Stallman <rms@gnu.org>
parents:
45695
diff
changeset
|
532 (car list))) |
af30a5644ebc
(copy-list): Moved back from subr.el.
Richard M. Stallman <rms@gnu.org>
parents:
45695
diff
changeset
|
533 |
4355 | 534 (defun cl-maclisp-member (item list) |
535 (while (and list (not (equal item (car list)))) (setq list (cdr list))) | |
536 list) | |
537 | |
538 (defalias 'cl-member 'memq) ; for compatibility with old CL package | |
539 (defalias 'cl-floor 'floor*) | |
540 (defalias 'cl-ceiling 'ceiling*) | |
541 (defalias 'cl-truncate 'truncate*) | |
542 (defalias 'cl-round 'round*) | |
543 (defalias 'cl-mod 'mod*) | |
544 | |
545 (defun adjoin (cl-item cl-list &rest cl-keys) ; See compiler macro in cl-macs | |
546 "Return ITEM consed onto the front of LIST only if it's not already there. | |
547 Otherwise, return LIST unmodified. | |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
548 \nKeywords supported: :test :test-not :key |
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
549 \n(fn ITEM LIST [KEYWORD VALUE]...)" |
4355 | 550 (cond ((or (equal cl-keys '(:test eq)) |
551 (and (null cl-keys) (not (numberp cl-item)))) | |
552 (if (memq cl-item cl-list) cl-list (cons cl-item cl-list))) | |
553 ((or (equal cl-keys '(:test equal)) (null cl-keys)) | |
554 (if (member cl-item cl-list) cl-list (cons cl-item cl-list))) | |
555 (t (apply 'cl-adjoin cl-item cl-list cl-keys)))) | |
556 | |
557 (defun subst (cl-new cl-old cl-tree &rest cl-keys) | |
558 "Substitute NEW for OLD everywhere in TREE (non-destructively). | |
559 Return a copy of TREE with all elements `eql' to OLD replaced by NEW. | |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
560 \nKeywords supported: :test :test-not :key |
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
561 \n(fn NEW OLD TREE [KEYWORD VALUE]...)" |
4355 | 562 (if (or cl-keys (and (numberp cl-old) (not (integerp cl-old)))) |
563 (apply 'sublis (list (cons cl-old cl-new)) cl-tree cl-keys) | |
564 (cl-do-subst cl-new cl-old cl-tree))) | |
565 | |
566 (defun cl-do-subst (cl-new cl-old cl-tree) | |
567 (cond ((eq cl-tree cl-old) cl-new) | |
568 ((consp cl-tree) | |
569 (let ((a (cl-do-subst cl-new cl-old (car cl-tree))) | |
570 (d (cl-do-subst cl-new cl-old (cdr cl-tree)))) | |
571 (if (and (eq a (car cl-tree)) (eq d (cdr cl-tree))) | |
572 cl-tree (cons a d)))) | |
573 (t cl-tree))) | |
574 | |
62642
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
575 (defun acons (key value alist) |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
576 "Add KEY and VALUE to ALIST. |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
577 Return a new list with (cons KEY VALUE) as car and ALIST as cdr." |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
578 (cons (cons key value) alist)) |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
579 |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
580 (defun pairlis (keys values &optional alist) |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
581 "Make an alist from KEYS and VALUES. |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
582 Return a new alist composed by associating KEYS to corresponding VALUES; |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
583 the process stops as soon as KEYS or VALUES run out. |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
584 If ALIST is non-nil, the new pairs are prepended to it." |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
585 (nconc (mapcar* 'cons keys values) alist)) |
4355 | 586 |
587 | |
588 ;;; Miscellaneous. | |
589 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
590 ;; Define data for indentation and edebug. |
81636
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
591 (dolist (entry |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
592 '(((defun* defmacro*) 2) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
593 ((function*) nil |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
594 (&or symbolp ([&optional 'macro] 'lambda (&rest sexp) &rest form))) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
595 ((eval-when) 1 (sexp &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
596 ((declare) nil (&rest sexp)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
597 ((the) 1 (sexp &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
598 ((case ecase typecase etypecase) 1 (form &rest (sexp &rest form))) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
599 ((block return-from) 1 (sexp &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
600 ((return) nil (&optional form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
601 ((do do*) 2 ((&rest &or symbolp (symbolp &optional form form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
602 (form &rest form) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
603 &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
604 ((do-symbols) 1 ((symbolp form &optional form form) &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
605 ((do-all-symbols) 1 ((symbolp form &optional form) &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
606 ((psetq setf psetf) nil edebug-setq-form) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
607 ((progv) 2 (&rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
608 ((flet labels macrolet) 1 |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
609 ((&rest (sexp sexp &rest form)) &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
610 ((symbol-macrolet lexical-let lexical-let*) 1 |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
611 ((&rest &or symbolp (symbolp form)) &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
612 ((multiple-value-bind) 2 ((&rest symbolp) &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
613 ((multiple-value-setq) 1 ((&rest symbolp) &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
614 ((incf decf remf pushnew shiftf rotatef) nil (&rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
615 ((letf letf*) 1 ((&rest (&rest form)) &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
616 ((callf destructuring-bind) 2 (sexp form &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
617 ((callf2) 3 (sexp form form &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
618 ((loop) nil (&rest &or symbolp form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
619 ((ignore-errors) 0 (&rest form)))) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
620 (dolist (func (car entry)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
621 (put func 'lisp-indent-function (nth 1 entry)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
622 (put func 'lisp-indent-hook (nth 1 entry)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
623 (or (get func 'edebug-form-spec) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
624 (put func 'edebug-form-spec (nth 2 entry))))) |
30613
a262f769fc3d
(first, ..., tenth): Make them macros.
Gerd Moellmann <gerd@gnu.org>
parents:
28824
diff
changeset
|
625 |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
626 ;; Autoload the other portions of the package. |
53595
7ea1b7196d49
*** empty log message ***
Luc Teirlinck <teirllm@auburn.edu>
parents:
53594
diff
changeset
|
627 ;; We want to replace the basic versions of dolist, dotimes, declare below. |
36551
54fe96bd9530
(dotimes, dolist): Undef prior to autoloading
Dave Love <fx@gnu.org>
parents:
34899
diff
changeset
|
628 (fmakunbound 'dolist) |
54fe96bd9530
(dotimes, dolist): Undef prior to autoloading
Dave Love <fx@gnu.org>
parents:
34899
diff
changeset
|
629 (fmakunbound 'dotimes) |
53594
587ca9eaf25e
Add `fmakunbound' for `declare'.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
630 (fmakunbound 'declare) |
81805
05153ccde019
Load cl-loaddefs.el quietly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81658
diff
changeset
|
631 (load "cl-loaddefs" nil 'quiet) |
4355 | 632 |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
633 ;; This goes here so that cl-macs can find it if it loads right now. |
4355 | 634 (provide 'cl-19) ; usage: (require 'cl-19 "cl") |
635 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
636 ;; Things to do after byte-compiler is loaded. |
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
637 ;; As a side effect, we cause cl-macs to be loaded when compiling, so |
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
638 ;; that the compiler-macros defined there will be present. |
4355 | 639 |
640 (defvar cl-hacked-flag nil) | |
641 (defun cl-hack-byte-compiler () | |
642 (if (and (not cl-hacked-flag) (fboundp 'byte-compile-file-form)) | |
643 (progn | |
46356
35f0290a4079
(cl-set-substring): Fix thinko.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46325
diff
changeset
|
644 (setq cl-hacked-flag t) ; Do it first, to prevent recursion. |
35f0290a4079
(cl-set-substring): Fix thinko.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46325
diff
changeset
|
645 (cl-compile-time-init)))) ; In cl-macs.el. |
4355 | 646 |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
647 ;; Try it now in case the compiler has already been loaded. |
4355 | 648 (cl-hack-byte-compiler) |
649 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
650 ;; Also make a hook in case compiler is loaded after this file. |
27586
5d6eb73b10d0
Use bytecomp-load-hook, not emacs-lisp-mode-hook.
Dave Love <fx@gnu.org>
parents:
27509
diff
changeset
|
651 (add-hook 'bytecomp-load-hook 'cl-hack-byte-compiler) |
4355 | 652 |
653 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
654 ;; The following ensures that packages which expect the old-style cl.el |
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
655 ;; will be happy with this one. |
4355 | 656 |
657 (provide 'cl) | |
658 | |
659 (run-hooks 'cl-load-hook) | |
660 | |
85736
e5bd859d65dd
Move local variables to end of file, and set byte-compile-warnings to
Glenn Morris <rgm@gnu.org>
parents:
82140
diff
changeset
|
661 ;; Local variables: |
e5bd859d65dd
Move local variables to end of file, and set byte-compile-warnings to
Glenn Morris <rgm@gnu.org>
parents:
82140
diff
changeset
|
662 ;; byte-compile-dynamic: t |
e5bd859d65dd
Move local variables to end of file, and set byte-compile-warnings to
Glenn Morris <rgm@gnu.org>
parents:
82140
diff
changeset
|
663 ;; byte-compile-warnings: (not cl-functions) |
e5bd859d65dd
Move local variables to end of file, and set byte-compile-warnings to
Glenn Morris <rgm@gnu.org>
parents:
82140
diff
changeset
|
664 ;; End: |
e5bd859d65dd
Move local variables to end of file, and set byte-compile-warnings to
Glenn Morris <rgm@gnu.org>
parents:
82140
diff
changeset
|
665 |
62630
630219b07e90
(eql): Remove. It's a builtin already.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
62626
diff
changeset
|
666 ;; arch-tag: 5f07fa74-f153-4524-9303-21f5be125851 |
4355 | 667 ;;; cl.el ends here |