Mercurial > emacs
annotate lisp/emacs-lisp/cl.el @ 88088:985bbb7a574c
emacs-lisp-intro.texi: Update back cover text.
author | Robert J. Chassell <bob@rattlesnake.com> |
---|---|
date | Thu, 31 Jan 2008 02:24:20 +0000 |
parents | 107ccd98fa12 |
children | 606f2d163a64 90a2847062be |
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 | |
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 | |
78217
935157c0b596
Switch license to GPLv3 or later.
Glenn Morris <rgm@gnu.org>
parents:
75346
diff
changeset
|
14 ;; the Free Software Foundation; either version 3, 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 | |
85834
7400d979a9d9
(cl-cannot-unload): Remove function.
Juanma Barranquero <lekktu@gmail.com>
parents:
85736
diff
changeset
|
112 (defun cl-unload-function () |
7400d979a9d9
(cl-cannot-unload): Remove function.
Juanma Barranquero <lekktu@gmail.com>
parents:
85736
diff
changeset
|
113 "Stop unloading of the Common Lisp extensions." |
7400d979a9d9
(cl-cannot-unload): Remove function.
Juanma Barranquero <lekktu@gmail.com>
parents:
85736
diff
changeset
|
114 (message "Cannot unload the feature `cl'") |
7400d979a9d9
(cl-cannot-unload): Remove function.
Juanma Barranquero <lekktu@gmail.com>
parents:
85736
diff
changeset
|
115 ;; stop standard unloading! |
7400d979a9d9
(cl-cannot-unload): Remove function.
Juanma Barranquero <lekktu@gmail.com>
parents:
85736
diff
changeset
|
116 t) |
4355 | 117 |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
118 ;;; Generalized variables. |
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
119 ;; 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
|
120 ;; can safely be used in .emacs files. |
4355 | 121 |
122 (defmacro incf (place &optional x) | |
28824
add63b27c709
Doc fixes; mainly avoid duplicating arg
Dave Love <fx@gnu.org>
parents:
28038
diff
changeset
|
123 "Increment PLACE by X (1 by default). |
4355 | 124 PLACE may be a symbol, or any generalized variable allowed by `setf'. |
125 The return value is the incremented value of PLACE." | |
126 (if (symbolp place) | |
127 (list 'setq place (if x (list '+ place x) (list '1+ place))) | |
128 (list 'callf '+ place (or x 1)))) | |
129 | |
130 (defmacro decf (place &optional x) | |
28824
add63b27c709
Doc fixes; mainly avoid duplicating arg
Dave Love <fx@gnu.org>
parents:
28038
diff
changeset
|
131 "Decrement PLACE by X (1 by default). |
4355 | 132 PLACE may be a symbol, or any generalized variable allowed by `setf'. |
133 The return value is the decremented value of PLACE." | |
134 (if (symbolp place) | |
135 (list 'setq place (if x (list '- place x) (list '1- place))) | |
136 (list 'callf '- place (or x 1)))) | |
137 | |
138 (defmacro pop (place) | |
28824
add63b27c709
Doc fixes; mainly avoid duplicating arg
Dave Love <fx@gnu.org>
parents:
28038
diff
changeset
|
139 "Remove and return the head of the list stored in PLACE. |
4355 | 140 Analogous to (prog1 (car PLACE) (setf PLACE (cdr PLACE))), though more |
141 careful about evaluating each argument only once and in the right order. | |
142 PLACE may be a symbol, or any generalized variable allowed by `setf'." | |
143 (if (symbolp place) | |
144 (list 'car (list 'prog1 place (list 'setq place (list 'cdr place)))) | |
145 (cl-do-pop place))) | |
146 | |
147 (defmacro push (x place) | |
28824
add63b27c709
Doc fixes; mainly avoid duplicating arg
Dave Love <fx@gnu.org>
parents:
28038
diff
changeset
|
148 "Insert X at the head of the list stored in PLACE. |
4355 | 149 Analogous to (setf PLACE (cons X PLACE)), though more careful about |
150 evaluating each argument only once and in the right order. PLACE may | |
151 be a symbol, or any generalized variable allowed by `setf'." | |
152 (if (symbolp place) (list 'setq place (list 'cons x place)) | |
153 (list 'callf2 'cons x place))) | |
154 | |
155 (defmacro pushnew (x place &rest keys) | |
156 "(pushnew X PLACE): insert X at the head of the list if not already there. | |
157 Like (push X PLACE), except that the list is unmodified if X is `eql' to | |
158 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
|
159 \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
|
160 \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
|
161 (if (symbolp place) |
a384943e84d7
(pushnew): Use add-to-list when convenient.
Richard M. Stallman <rms@gnu.org>
parents:
68648
diff
changeset
|
162 (if (null keys) |
73227
79c3587798b4
(pushnew-internal): Remove defvar.
Kim F. Storm <storm@cua.dk>
parents:
73030
diff
changeset
|
163 `(let ((x ,x)) |
79c3587798b4
(pushnew-internal): Remove defvar.
Kim F. Storm <storm@cua.dk>
parents:
73030
diff
changeset
|
164 (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
|
165 (list 'setq place (list* 'adjoin x place keys))) |
4355 | 166 (list* 'callf2 'adjoin x place keys))) |
167 | |
168 (defun cl-set-elt (seq n val) | |
169 (if (listp seq) (setcar (nthcdr n seq) val) (aset seq n val))) | |
170 | |
171 (defun cl-set-nthcdr (n list x) | |
172 (if (<= n 0) x (setcdr (nthcdr (1- n) list) x) list)) | |
173 | |
174 (defun cl-set-buffer-substring (start end val) | |
175 (save-excursion (delete-region start end) | |
176 (goto-char start) | |
177 (insert val) | |
178 val)) | |
179 | |
180 (defun cl-set-substring (str start end val) | |
181 (if end (if (< end 0) (incf end (length str))) | |
182 (setq end (length str))) | |
46356
35f0290a4079
(cl-set-substring): Fix thinko.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46325
diff
changeset
|
183 (if (< start 0) (incf start (length str))) |
4355 | 184 (concat (and (> start 0) (substring str 0 start)) |
185 val | |
186 (and (< end (length str)) (substring str end)))) | |
187 | |
188 | |
189 ;;; Control structures. | |
190 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
191 ;; 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
|
192 ;; them all the time than to load them from cl-macs.el. |
4355 | 193 |
194 (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
|
195 (apply 'cl-map-overlays cl-args)) |
4355 | 196 |
197 | |
198 ;;; Blocks and exits. | |
199 | |
200 (defalias 'cl-block-wrapper 'identity) | |
201 (defalias 'cl-block-throw 'throw) | |
202 | |
203 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
204 ;;; Multiple values. |
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
205 ;; 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
|
206 ;; 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
|
207 ;; the target form to return the values as a list. |
4355 | 208 |
41109
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
209 (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
|
210 "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
|
211 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
|
212 that the containing function should return." |
46027
38072df535c8
(values): Simplify definition.
Richard M. Stallman <rms@gnu.org>
parents:
45739
diff
changeset
|
213 values) |
41109
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
214 |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
215 (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
|
216 "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
|
217 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
|
218 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
|
219 list) |
4355 | 220 |
41109
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
221 (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
|
222 "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
|
223 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
|
224 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
|
225 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
|
226 expression) |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
227 |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
228 (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
|
229 "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
|
230 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
|
231 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
|
232 one value." |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
233 (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
|
234 |
48462
b9d1a3c5291e
(multiple-value-call): Add docstring.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46356
diff
changeset
|
235 (defalias 'multiple-value-call 'apply |
b9d1a3c5291e
(multiple-value-call): Add docstring.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46356
diff
changeset
|
236 "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
|
237 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
|
238 |
41109
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
239 (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
|
240 "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
|
241 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
|
242 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
|
243 one value." |
0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Richard M. Stallman <rms@gnu.org>
parents:
39630
diff
changeset
|
244 (nth n expression)) |
4355 | 245 |
246 ;;; Macros. | |
247 | |
248 (defvar cl-macro-environment nil) | |
249 (defvar cl-old-macroexpand (prog1 (symbol-function 'macroexpand) | |
250 (defalias 'macroexpand 'cl-macroexpand))) | |
251 | |
252 (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
|
253 "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
|
254 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
|
255 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
|
256 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
|
257 |
30998 | 258 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
|
259 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
|
260 \n(fn FORM &optional ENVIRONMENT)" |
4355 | 261 (let ((cl-macro-environment cl-env)) |
262 (while (progn (setq cl-macro (funcall cl-old-macroexpand cl-macro cl-env)) | |
263 (and (symbolp cl-macro) | |
264 (cdr (assq (symbol-name cl-macro) cl-env)))) | |
265 (setq cl-macro (cadr (assq (symbol-name cl-macro) cl-env)))) | |
266 cl-macro)) | |
267 | |
268 | |
269 ;;; Declarations. | |
270 | |
271 (defvar cl-compiling-file nil) | |
272 (defun cl-compiling-file () | |
273 (or cl-compiling-file | |
274 (and (boundp 'outbuffer) (bufferp (symbol-value 'outbuffer)) | |
275 (equal (buffer-name (symbol-value 'outbuffer)) | |
276 " *Compiler Output*")))) | |
277 | |
278 (defvar cl-proclaims-deferred nil) | |
279 | |
280 (defun proclaim (spec) | |
281 (if (fboundp 'cl-do-proclaim) (cl-do-proclaim spec t) | |
282 (push spec cl-proclaims-deferred)) | |
283 nil) | |
284 | |
285 (defmacro declaim (&rest specs) | |
286 (let ((body (mapcar (function (lambda (x) (list 'proclaim (list 'quote x)))) | |
287 specs))) | |
288 (if (cl-compiling-file) (list* 'eval-when '(compile load eval) body) | |
289 (cons 'progn body)))) ; avoid loading cl-macs.el for eval-when | |
290 | |
291 | |
292 ;;; Symbols. | |
293 | |
294 (defun cl-random-time () | |
295 (let* ((time (copy-sequence (current-time-string))) (i (length time)) (v 0)) | |
296 (while (>= (decf i) 0) (setq v (+ (* v 3) (aref time i)))) | |
297 v)) | |
298 | |
299 (defvar *gensym-counter* (* (logand (cl-random-time) 1023) 100)) | |
300 | |
301 | |
302 ;;; Numbers. | |
303 | |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
304 (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
|
305 "Return t if OBJECT is a floating point number. |
4355 | 306 On Emacs versions that lack floating-point support, this function |
307 always returns nil." | |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
308 (and (numberp object) (not (integerp object)))) |
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 plusp (number) |
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 NUMBER is positive." |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
312 (> number 0)) |
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 minusp (number) |
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 NUMBER is negative." |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
316 (< number 0)) |
4355 | 317 |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
318 (defun oddp (integer) |
62424
ecbd5b866b1d
(eql, floatp-safe, plusp, minusp, oddp, evenp, list*): Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
parents:
57519
diff
changeset
|
319 "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
|
320 (eq (logand integer 1) 1)) |
4355 | 321 |
62626
970aed705a2a
(pushnew, cl-macroexpand, floatp-safe, plusp, minusp, oddp, evenp, mapcar*,
Juanma Barranquero <lekktu@gmail.com>
parents:
62424
diff
changeset
|
322 (defun evenp (integer) |
62424
ecbd5b866b1d
(eql, floatp-safe, plusp, minusp, oddp, evenp, list*): Doc fixes.
Juanma Barranquero <lekktu@gmail.com>
parents:
57519
diff
changeset
|
323 "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
|
324 (eq (logand integer 1) 0)) |
4355 | 325 |
326 (defvar *random-state* (vector 'cl-random-state-tag -1 30 (cl-random-time))) | |
327 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
328 ;; The following are actually set by cl-float-limits. |
4355 | 329 (defconst most-positive-float nil) |
330 (defconst most-negative-float nil) | |
331 (defconst least-positive-float nil) | |
332 (defconst least-negative-float nil) | |
333 (defconst least-positive-normalized-float nil) | |
334 (defconst least-negative-normalized-float nil) | |
335 (defconst float-epsilon nil) | |
336 (defconst float-negative-epsilon nil) | |
337 | |
338 | |
339 ;;; Sequence functions. | |
340 | |
341 (defalias 'copy-seq 'copy-sequence) | |
342 | |
343 (defun mapcar* (cl-func cl-x &rest cl-rest) | |
344 "Apply FUNCTION to each element of SEQ, and make a list of the results. | |
345 If there are several SEQs, FUNCTION is called with that many arguments, | |
346 and mapping stops as soon as the shortest list runs out. With just one | |
347 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
|
348 `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
|
349 \n(fn FUNCTION SEQ...)" |
4355 | 350 (if cl-rest |
351 (if (or (cdr cl-rest) (nlistp cl-x) (nlistp (car cl-rest))) | |
352 (cl-mapcar-many cl-func (cons cl-x cl-rest)) | |
353 (let ((cl-res nil) (cl-y (car cl-rest))) | |
354 (while (and cl-x cl-y) | |
355 (push (funcall cl-func (pop cl-x) (pop cl-y)) cl-res)) | |
356 (nreverse cl-res))) | |
357 (mapcar cl-func cl-x))) | |
358 | |
41776
2682c3f36a6a
(svref): New alias.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
41109
diff
changeset
|
359 (defalias 'svref 'aref) |
4355 | 360 |
361 ;;; List functions. | |
362 | |
363 (defalias 'first 'car) | |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
364 (defalias 'second 'cadr) |
4355 | 365 (defalias 'rest 'cdr) |
366 (defalias 'endp 'null) | |
367 | |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
368 (defun third (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 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
|
370 (car (cdr (cdr x)))) |
4355 | 371 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
372 (defun fourth (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 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
|
374 (nth 3 x)) |
4355 | 375 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
376 (defun fifth (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 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
|
378 (nth 4 x)) |
4355 | 379 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
380 (defun sixth (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 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
|
382 (nth 5 x)) |
4355 | 383 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
384 (defun seventh (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 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
|
386 (nth 6 x)) |
4355 | 387 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
388 (defun eighth (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 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
|
390 (nth 7 x)) |
4355 | 391 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
392 (defun ninth (x) |
34027
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
393 "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
|
394 (nth 8 x)) |
4355 | 395 |
30617
5e28cf8a757a
(third...tenth): Undo change of 2000-08-05.
Gerd Moellmann <gerd@gnu.org>
parents:
30613
diff
changeset
|
396 (defun tenth (x) |
34027
5fc589b932e9
(third...tenth): Really undo change of 2000-08-05.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
30998
diff
changeset
|
397 "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
|
398 (nth 9 x)) |
4355 | 399 |
400 (defun caaar (x) | |
401 "Return the `car' of the `car' of the `car' of X." | |
402 (car (car (car x)))) | |
403 | |
404 (defun caadr (x) | |
405 "Return the `car' of the `car' of the `cdr' of X." | |
406 (car (car (cdr x)))) | |
407 | |
408 (defun cadar (x) | |
409 "Return the `car' of the `cdr' of the `car' of X." | |
410 (car (cdr (car x)))) | |
411 | |
412 (defun caddr (x) | |
413 "Return the `car' of the `cdr' of the `cdr' of X." | |
414 (car (cdr (cdr x)))) | |
415 | |
416 (defun cdaar (x) | |
417 "Return the `cdr' of the `car' of the `car' of X." | |
418 (cdr (car (car x)))) | |
419 | |
420 (defun cdadr (x) | |
421 "Return the `cdr' of the `car' of the `cdr' of X." | |
422 (cdr (car (cdr x)))) | |
423 | |
424 (defun cddar (x) | |
425 "Return the `cdr' of the `cdr' of the `car' of X." | |
426 (cdr (cdr (car x)))) | |
427 | |
428 (defun cdddr (x) | |
429 "Return the `cdr' of the `cdr' of the `cdr' of X." | |
430 (cdr (cdr (cdr x)))) | |
431 | |
432 (defun caaaar (x) | |
433 "Return the `car' of the `car' of the `car' of the `car' of X." | |
434 (car (car (car (car x))))) | |
435 | |
436 (defun caaadr (x) | |
437 "Return the `car' of the `car' of the `car' of the `cdr' of X." | |
438 (car (car (car (cdr x))))) | |
439 | |
440 (defun caadar (x) | |
441 "Return the `car' of the `car' of the `cdr' of the `car' of X." | |
442 (car (car (cdr (car x))))) | |
443 | |
444 (defun caaddr (x) | |
445 "Return the `car' of the `car' of the `cdr' of the `cdr' of X." | |
446 (car (car (cdr (cdr x))))) | |
447 | |
448 (defun cadaar (x) | |
449 "Return the `car' of the `cdr' of the `car' of the `car' of X." | |
450 (car (cdr (car (car x))))) | |
451 | |
452 (defun cadadr (x) | |
453 "Return the `car' of the `cdr' of the `car' of the `cdr' of X." | |
454 (car (cdr (car (cdr x))))) | |
455 | |
456 (defun caddar (x) | |
457 "Return the `car' of the `cdr' of the `cdr' of the `car' of X." | |
458 (car (cdr (cdr (car x))))) | |
459 | |
460 (defun cadddr (x) | |
461 "Return the `car' of the `cdr' of the `cdr' of the `cdr' of X." | |
462 (car (cdr (cdr (cdr x))))) | |
463 | |
464 (defun cdaaar (x) | |
465 "Return the `cdr' of the `car' of the `car' of the `car' of X." | |
466 (cdr (car (car (car x))))) | |
467 | |
468 (defun cdaadr (x) | |
469 "Return the `cdr' of the `car' of the `car' of the `cdr' of X." | |
470 (cdr (car (car (cdr x))))) | |
471 | |
472 (defun cdadar (x) | |
473 "Return the `cdr' of the `car' of the `cdr' of the `car' of X." | |
474 (cdr (car (cdr (car x))))) | |
475 | |
476 (defun cdaddr (x) | |
477 "Return the `cdr' of the `car' of the `cdr' of the `cdr' of X." | |
478 (cdr (car (cdr (cdr x))))) | |
479 | |
480 (defun cddaar (x) | |
481 "Return the `cdr' of the `cdr' of the `car' of the `car' of X." | |
482 (cdr (cdr (car (car x))))) | |
483 | |
484 (defun cddadr (x) | |
485 "Return the `cdr' of the `cdr' of the `car' of the `cdr' of X." | |
486 (cdr (cdr (car (cdr x))))) | |
487 | |
488 (defun cdddar (x) | |
489 "Return the `cdr' of the `cdr' of the `cdr' of the `car' of X." | |
490 (cdr (cdr (cdr (car x))))) | |
491 | |
492 (defun cddddr (x) | |
493 "Return the `cdr' of the `cdr' of the `cdr' of the `cdr' of X." | |
494 (cdr (cdr (cdr (cdr x))))) | |
495 | |
19585
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
496 ;;(defun last* (x &optional n) |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
497 ;; "Returns the last link in the list LIST. |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
498 ;;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
|
499 ;; (if n |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
500 ;; (let ((m 0) (p x)) |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
501 ;; (while (consp p) (incf m) (pop p)) |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
502 ;; (if (<= n 0) p |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
503 ;; (if (< n m) (nthcdr (- m n) x) x))) |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
504 ;; (while (consp (cdr x)) (pop x)) |
3d2741d4fabc
(last*): Definition deleted.
Richard M. Stallman <rms@gnu.org>
parents:
19512
diff
changeset
|
505 ;; x)) |
4355 | 506 |
507 (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
|
508 "Return a new list with specified ARGs as elements, consed to last ARG. |
4355 | 509 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
|
510 `(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
|
511 \n(fn ARG...)" |
4355 | 512 (cond ((not rest) arg) |
513 ((not (cdr rest)) (cons arg (car rest))) | |
514 (t (let* ((n (length rest)) | |
515 (copy (copy-sequence rest)) | |
516 (last (nthcdr (- n 2) copy))) | |
517 (setcdr last (car (cdr last))) | |
518 (cons arg copy))))) | |
519 | |
520 (defun ldiff (list sublist) | |
521 "Return a copy of LIST with the tail SUBLIST removed." | |
522 (let ((res nil)) | |
523 (while (and (consp list) (not (eq list sublist))) | |
524 (push (pop list) res)) | |
525 (nreverse res))) | |
526 | |
45739
af30a5644ebc
(copy-list): Moved back from subr.el.
Richard M. Stallman <rms@gnu.org>
parents:
45695
diff
changeset
|
527 (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
|
528 "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
|
529 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
|
530 (if (consp list) |
af30a5644ebc
(copy-list): Moved back from subr.el.
Richard M. Stallman <rms@gnu.org>
parents:
45695
diff
changeset
|
531 (let ((res nil)) |
af30a5644ebc
(copy-list): Moved back from subr.el.
Richard M. Stallman <rms@gnu.org>
parents:
45695
diff
changeset
|
532 (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
|
533 (prog1 (nreverse res) (setcdr res list))) |
af30a5644ebc
(copy-list): Moved back from subr.el.
Richard M. Stallman <rms@gnu.org>
parents:
45695
diff
changeset
|
534 (car list))) |
af30a5644ebc
(copy-list): Moved back from subr.el.
Richard M. Stallman <rms@gnu.org>
parents:
45695
diff
changeset
|
535 |
4355 | 536 (defun cl-maclisp-member (item list) |
537 (while (and list (not (equal item (car list)))) (setq list (cdr list))) | |
538 list) | |
539 | |
540 (defalias 'cl-member 'memq) ; for compatibility with old CL package | |
541 (defalias 'cl-floor 'floor*) | |
542 (defalias 'cl-ceiling 'ceiling*) | |
543 (defalias 'cl-truncate 'truncate*) | |
544 (defalias 'cl-round 'round*) | |
545 (defalias 'cl-mod 'mod*) | |
546 | |
547 (defun adjoin (cl-item cl-list &rest cl-keys) ; See compiler macro in cl-macs | |
548 "Return ITEM consed onto the front of LIST only if it's not already there. | |
549 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
|
550 \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
|
551 \n(fn ITEM LIST [KEYWORD VALUE]...)" |
4355 | 552 (cond ((or (equal cl-keys '(:test eq)) |
553 (and (null cl-keys) (not (numberp cl-item)))) | |
554 (if (memq cl-item cl-list) cl-list (cons cl-item cl-list))) | |
555 ((or (equal cl-keys '(:test equal)) (null cl-keys)) | |
556 (if (member cl-item cl-list) cl-list (cons cl-item cl-list))) | |
557 (t (apply 'cl-adjoin cl-item cl-list cl-keys)))) | |
558 | |
559 (defun subst (cl-new cl-old cl-tree &rest cl-keys) | |
560 "Substitute NEW for OLD everywhere in TREE (non-destructively). | |
561 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
|
562 \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
|
563 \n(fn NEW OLD TREE [KEYWORD VALUE]...)" |
4355 | 564 (if (or cl-keys (and (numberp cl-old) (not (integerp cl-old)))) |
565 (apply 'sublis (list (cons cl-old cl-new)) cl-tree cl-keys) | |
566 (cl-do-subst cl-new cl-old cl-tree))) | |
567 | |
568 (defun cl-do-subst (cl-new cl-old cl-tree) | |
569 (cond ((eq cl-tree cl-old) cl-new) | |
570 ((consp cl-tree) | |
571 (let ((a (cl-do-subst cl-new cl-old (car cl-tree))) | |
572 (d (cl-do-subst cl-new cl-old (cdr cl-tree)))) | |
573 (if (and (eq a (car cl-tree)) (eq d (cdr cl-tree))) | |
574 cl-tree (cons a d)))) | |
575 (t cl-tree))) | |
576 | |
62642
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
577 (defun acons (key value alist) |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
578 "Add KEY and VALUE to ALIST. |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
579 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
|
580 (cons (cons key value) alist)) |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
581 |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
582 (defun pairlis (keys values &optional alist) |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
583 "Make an alist from KEYS and VALUES. |
59b6666e38f9
(acons, pairlis): Add docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
62630
diff
changeset
|
584 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
|
585 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
|
586 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
|
587 (nconc (mapcar* 'cons keys values) alist)) |
4355 | 588 |
589 | |
590 ;;; Miscellaneous. | |
591 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
592 ;; 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
|
593 (dolist (entry |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
594 '(((defun* defmacro*) 2) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
595 ((function*) nil |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
596 (&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
|
597 ((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
|
598 ((declare) nil (&rest sexp)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
599 ((the) 1 (sexp &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
600 ((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
|
601 ((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
|
602 ((return) nil (&optional form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
603 ((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
|
604 (form &rest form) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
605 &rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
606 ((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
|
607 ((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
|
608 ((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
|
609 ((progv) 2 (&rest form)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
610 ((flet labels macrolet) 1 |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
611 ((&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
|
612 ((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
|
613 ((&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
|
614 ((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
|
615 ((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
|
616 ((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
|
617 ((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
|
618 ((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
|
619 ((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
|
620 ((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
|
621 ((ignore-errors) 0 (&rest form)))) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
622 (dolist (func (car entry)) |
432e796ebb5c
Use cl-loaddefs.el rather than manual autoloads.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
75346
diff
changeset
|
623 (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
|
624 (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
|
625 (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
|
626 (put func 'edebug-form-spec (nth 2 entry))))) |
30613
a262f769fc3d
(first, ..., tenth): Make them macros.
Gerd Moellmann <gerd@gnu.org>
parents:
28824
diff
changeset
|
627 |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
628 ;; Autoload the other portions of the package. |
53595
7ea1b7196d49
*** empty log message ***
Luc Teirlinck <teirllm@auburn.edu>
parents:
53594
diff
changeset
|
629 ;; 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
|
630 (fmakunbound 'dolist) |
54fe96bd9530
(dotimes, dolist): Undef prior to autoloading
Dave Love <fx@gnu.org>
parents:
34899
diff
changeset
|
631 (fmakunbound 'dotimes) |
53594
587ca9eaf25e
Add `fmakunbound' for `declare'.
Luc Teirlinck <teirllm@auburn.edu>
parents:
52401
diff
changeset
|
632 (fmakunbound 'declare) |
81805
05153ccde019
Load cl-loaddefs.el quietly.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81658
diff
changeset
|
633 (load "cl-loaddefs" nil 'quiet) |
4355 | 634 |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
635 ;; This goes here so that cl-macs can find it if it loads right now. |
4355 | 636 (provide 'cl-19) ; usage: (require 'cl-19 "cl") |
637 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
638 ;; 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
|
639 ;; 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
|
640 ;; that the compiler-macros defined there will be present. |
4355 | 641 |
642 (defvar cl-hacked-flag nil) | |
643 (defun cl-hack-byte-compiler () | |
644 (if (and (not cl-hacked-flag) (fboundp 'byte-compile-file-form)) | |
645 (progn | |
46356
35f0290a4079
(cl-set-substring): Fix thinko.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
46325
diff
changeset
|
646 (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
|
647 (cl-compile-time-init)))) ; In cl-macs.el. |
4355 | 648 |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
649 ;; Try it now in case the compiler has already been loaded. |
4355 | 650 (cl-hack-byte-compiler) |
651 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
652 ;; 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
|
653 (add-hook 'bytecomp-load-hook 'cl-hack-byte-compiler) |
4355 | 654 |
655 | |
81658
3ed52769155f
Set edebug and indentation before loading
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
81636
diff
changeset
|
656 ;; 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
|
657 ;; will be happy with this one. |
4355 | 658 |
659 (provide 'cl) | |
660 | |
661 (run-hooks 'cl-load-hook) | |
662 | |
85736
e5bd859d65dd
Move local variables to end of file, and set byte-compile-warnings to
Glenn Morris <rgm@gnu.org>
parents:
82140
diff
changeset
|
663 ;; 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
|
664 ;; 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
|
665 ;; 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
|
666 ;; End: |
e5bd859d65dd
Move local variables to end of file, and set byte-compile-warnings to
Glenn Morris <rgm@gnu.org>
parents:
82140
diff
changeset
|
667 |
62630
630219b07e90
(eql): Remove. It's a builtin already.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
62626
diff
changeset
|
668 ;; arch-tag: 5f07fa74-f153-4524-9303-21f5be125851 |
4355 | 669 ;;; cl.el ends here |