3 ;; JSCL is free software: you can redistribute it and/or
4 ;; modify it under the terms of the GNU General Public License as
5 ;; published by the Free Software Foundation, either version 3 of the
6 ;; License, or (at your option) any later version.
8 ;; JSCL is distributed in the hope that it will be useful, but
9 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
10 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 ;; General Public License for more details.
13 ;; You should have received a copy of the GNU General Public License
14 ;; along with JSCL. If not, see <http://www.gnu.org/licenses/>.
16 ;;;; Various list functions
18 (defun cons (x y) (cons x y))
19 (defun consp (x) (consp x))
22 (or (consp x) (null x)))
32 (error "The value `~S' is not a type list." x))))
35 "Return the CAR part of a cons, or NIL if X is null."
38 (defun cdr (x) (cdr x))
40 (defun first (x) (car x))
41 (defun second (x) (cadr x))
42 (defun third (x) (caddr x))
43 (defun fourth (x) (cadddr x))
44 (defun fifth (x) (car (cddddr x)))
45 (defun sixth (x) (cadr (cddddr x)))
46 (defun seventh (x) (caddr (cddddr x)))
47 (defun eighth (x) (cadddr (cddddr x)))
48 (defun ninth (x) (car (cddddr (cddddr x))))
49 (defun tenth (x) (cadr (cddddr (cddddr x))))
50 (defun rest (x) (cdr x))
52 (defun list (&rest args)
55 (defun list* (arg &rest others)
56 (cond ((null others) arg)
57 ((null (cdr others)) (cons arg (car others)))
58 (t (do ((x others (cdr x)))
59 ((null (cddr x)) (rplacd x (cadr x))))
62 (defun nthcdr (n list)
63 (while (and (plusp n) list)
65 (setq list (cdr list)))
69 (car (nthcdr n list)))
71 (define-setf-expander nth (n list)
72 (let ((g!list (gensym))
75 (values (list g!list g!index)
78 `(rplaca (nthcdr ,g!index ,g!list) ,g!value)
79 `(nth ,g!index ,g!list))))
81 (defun caar (x) (car (car x)))
82 (defun cadr (x) (car (cdr x)))
83 (defun cdar (x) (cdr (car x)))
84 (defun cddr (x) (cdr (cdr x)))
86 (defun caaar (x) (car (caar x)))
87 (defun caadr (x) (car (cadr x)))
88 (defun cadar (x) (car (cdar x)))
89 (defun caddr (x) (car (cddr x)))
90 (defun cdaar (x) (cdr (caar x)))
91 (defun cdadr (x) (cdr (cadr x)))
92 (defun cddar (x) (cdr (cdar x)))
93 (defun cdddr (x) (cdr (cddr x)))
95 (defun caaaar (x) (car (caaar x)))
96 (defun caaadr (x) (car (caadr x)))
97 (defun caadar (x) (car (cadar x)))
98 (defun caaddr (x) (car (caddr x)))
99 (defun cadaar (x) (car (cdaar x)))
100 (defun cadadr (x) (car (cdadr x)))
101 (defun caddar (x) (car (cddar x)))
102 (defun cadddr (x) (car (cdddr x)))
103 (defun cdaaar (x) (cdr (caaar x)))
104 (defun cdaadr (x) (cdr (caadr x)))
105 (defun cdadar (x) (cdr (cadar x)))
106 (defun cdaddr (x) (cdr (caddr x)))
107 (defun cddaar (x) (cdr (cdaar x)))
108 (defun cddadr (x) (cdr (cdadr x)))
109 (defun cdddar (x) (cdr (cddar x)))
110 (defun cddddr (x) (cdr (cdddr x)))
112 (defun sublis (alist tree &key key (test #'eql testp) (test-not #'eql test-not-p))
113 (when (and testp test-not-p)
114 (error "Both test and test-not are set"))
116 (let* ((key-val (if key (funcall key tree) tree))
117 (replace (if test-not-p
118 (assoc key-val alist :test-not test-not)
119 (assoc key-val alist :test test)))
120 (x (if replace (cdr replace) tree)))
123 (cons (s (car x)) (s (cdr x)))))))
126 (defun subst (new old tree &key key (test #'eql testp) (test-not #'eql test-not-p))
128 (cond ((satisfies-test-p old x :key key :test test :testp testp
129 :test-not test-not :test-not-p test-not-p)
132 (t (let ((a (s (car x)))
134 (if (and (eq a (car x))
141 (mapcar #'identity x))
143 (defun copy-tree (tree)
145 (cons (copy-tree (car tree))
146 (copy-tree (cdr tree)))
149 (defun tree-equal (tree1 tree2 &key (test #'eql testp)
150 (test-not #'eql test-not-p))
151 (when (and testp test-not-p) (error "Both test and test-not are set"))
152 (let ((func (if test-not-p (complement test-not) test)))
153 (labels ((%tree-equal (tree1 tree2)
155 (and (atom tree2) (funcall func tree1 tree2))
157 (%tree-equal (car tree1) (car tree2))
158 (%tree-equal (cdr tree1) (cdr tree2))))))
159 (%tree-equal tree1 tree2))))
161 (defun tailp (object list)
162 (do ((tail list (cdr tail)))
163 ((atom tail) (eq object tail))
164 (when (eql tail object)
165 (return-from tailp t))))
167 (defmacro pop (place)
168 (multiple-value-bind (dummies vals newval setter getter)
169 (get-setf-expansion place)
170 (let ((head (gensym)))
171 `(let* (,@(mapcar #'list dummies vals)
173 (,(car newval) (cdr ,head))
179 (defun map1 (func list)
182 (collect (funcall func (car list)))
183 (setq list (cdr list)))))
185 (defun mapcar (func list &rest lists)
186 (let ((lists (cons list lists)))
190 (let ((elems (map1 #'car lists)))
191 (do ((tail lists (cdr tail)))
193 (when (null (car tail)) (return-from loop))
194 (rplaca tail (cdar tail)))
195 (collect (apply func elems))))))))
197 (defun mapn (func list)
200 (collect (funcall func list))
201 (setq list (cdr list)))))
203 (defun maplist (func list &rest lists)
204 (let ((lists (cons list lists)))
208 (let ((elems (mapn #'car lists)))
209 (do ((tail lists (cdr tail)))
211 (when (null (car tail)) (return-from loop))
212 (rplaca tail (cdar tail)))
213 (collect (apply func elems))))))))
215 (defun mapc (func &rest lists)
216 (do* ((tails lists (map1 #'cdr tails))
217 (elems (map1 #'car tails)
219 ((dolist (x tails) (when (null x) (return t)))
224 (while (consp (cdr x))
230 (cons (car x) (butlast (cdr x)))))
232 (defun member (x list &key key (test #'eql testp) (test-not #'eql test-not-p))
234 (when (satisfies-test-p x (car list) :key key :test test :testp testp
235 :test-not test-not :test-not-p test-not-p)
237 (setq list (cdr list))))
240 (defun assoc (x alist &key key (test #'eql testp) (test-not #'eql test-not-p))
242 (if (satisfies-test-p x (caar alist) :key key :test test :testp testp
243 :test-not test-not :test-not-p test-not-p)
245 (setq alist (cdr alist))))
248 (defun rassoc (x alist &key key (test #'eql) (test #'eql testp)
249 (test-not #'eql test-not-p))
251 (if (satisfies-test-p x (cdar alist) :key key :test test :testp testp
252 :test-not test-not :test-not-p test-not-p)
254 (setq alist (cdr alist))))
257 (defun acons (key datum alist)
258 (cons (cons key datum) alist))
260 (defun pairlis (keys data &optional (alist ()))
262 (setq alist (acons (car keys) (car data) alist))
263 (setq keys (cdr keys))
264 (setq data (cdr data)))
267 (defun copy-alist (alist)
268 (let ((new-alist ()))
270 (push (cons (caar alist) (cdar alist)) new-alist)
271 (setq alist (cdr alist)))
272 (reverse new-alist)))
275 (define-setf-expander car (x)
276 (let ((cons (gensym))
277 (new-value (gensym)))
281 `(progn (rplaca ,cons ,new-value) ,new-value)
284 (define-setf-expander cdr (x)
285 (let ((cons (gensym))
286 (new-value (gensym)))
290 `(progn (rplacd ,cons ,new-value) ,new-value)
294 ;; The NCONC function is based on the SBCL's one.
295 (defun nconc (&rest lists)
296 (flet ((fail (object)
297 (error "type-error in nconc")))
298 (do ((top lists (cdr top)))
300 (let ((top-of-top (car top)))
303 (let* ((result top-of-top)
305 (do ((elements (cdr top) (cdr elements)))
307 (let ((ele (car elements)))
309 (cons (rplacd (last splice) ele)
311 (null (rplacd (last splice) nil))
312 (atom (if (cdr elements)
314 (rplacd (last splice) ele))))))
320 (return top-of-top))))))))
324 (do ((1st (cdr x) (if (endp 1st) 1st (cdr 1st)))
325 (2nd x 1st) ; 2nd follows first down the list.
326 (3rd y 2nd)) ;3rd follows 2nd down the list.
331 (defun adjoin (item list &key (test #'eql) (key #'identity))
332 (if (member item list :key key :test test)
336 (defun intersection (list1 list2 &key (test #'eql) (key #'identity))
339 (when (member (funcall key x) list2 :test test :key key)