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