1;; cl-compat.el --- Common Lisp extensions for GNU Emacs Lisp (compatibility) 2 3;; Copyright (C) 1993 Free Software Foundation, Inc. 4 5;; Author: Dave Gillespie <daveg@synaptics.com> 6;; Version: 2.02 7;; Keywords: extensions 8 9;; This file is part of GNU Emacs. 10 11;; GNU Emacs is free software; you can redistribute it and/or modify 12;; it under the terms of the GNU General Public License as published by 13;; the Free Software Foundation; either version 1, or (at your option) 14;; any later version. 15 16;; GNU Emacs is distributed in the hope that it will be useful, 17;; but WITHOUT ANY WARRANTY; without even the implied warranty of 18;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 19;; GNU General Public License for more details. 20 21;; You should have received a copy of the GNU General Public License 22;; along with GNU Emacs; see the file COPYING. If not, write to 23;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. 24 25;; Commentary: 26 27;; These are extensions to Emacs Lisp that provide a degree of 28;; Common Lisp compatibility, beyond what is already built-in 29;; in Emacs Lisp. 30;; 31;; This package was written by Dave Gillespie; it is a complete 32;; rewrite of Cesar Quiroz's original cl.el package of December 1986. 33;; 34;; This package works with Emacs 18, Emacs 19, and Lucid Emacs 19. 35;; 36;; Bug reports, comments, and suggestions are welcome! 37 38;; This file contains emulations of internal routines of the older 39;; CL package which users may have called directly from their code. 40;; Use (require 'cl-compat) to get these routines. 41 42;; See cl.el for Change Log. 43 44 45;; Code: 46 47;; Require at load-time, but not when compiling cl-compat. 48(or (featurep 'cl) (require 'cl)) 49 50 51;;; Keyword routines not supported by new package. 52 53(defmacro defkeyword (x &optional doc) 54 (list* 'defconst x (list 'quote x) (and doc (list doc)))) 55 56(defun keywordp (sym) 57 (and (symbolp sym) (eq (aref (symbol-name sym) 0) ?\:) (set sym sym))) 58 59(defun keyword-of (sym) 60 (or (keywordp sym) (keywordp (intern (format ":%s" sym))))) 61 62 63;;; Multiple values. Note that the new package uses a different 64;;; convention for multiple values. The following definitions 65;;; emulate the old convention; all function names have been changed 66;;; by capitalizing the first letter: Values, Multiple-value-*, 67;;; to avoid conflict with the new-style definitions in cl-macs. 68 69(put 'Multiple-value-bind 'lisp-indent-function 2) 70(put 'Multiple-value-setq 'lisp-indent-function 2) 71(put 'Multiple-value-call 'lisp-indent-function 1) 72(put 'Multiple-value-prog1 'lisp-indent-function 1) 73 74(defvar *mvalues-values* nil) 75 76(defun Values (&rest val-forms) 77 (setq *mvalues-values* val-forms) 78 (car val-forms)) 79 80(defun Values-list (val-forms) 81 (apply 'values val-forms)) 82 83(defmacro Multiple-value-list (form) 84 (list 'let* (list '(*mvalues-values* nil) (list '*mvalues-temp* form)) 85 '(or (and (eq *mvalues-temp* (car *mvalues-values*)) *mvalues-values*) 86 (list *mvalues-temp*)))) 87 88(defmacro Multiple-value-call (function &rest args) 89 (list 'apply function 90 (cons 'append 91 (mapcar (function (lambda (x) (list 'Multiple-value-list x))) 92 args)))) 93 94(defmacro Multiple-value-bind (vars form &rest body) 95 (list* 'multiple-value-bind vars (list 'Multiple-value-list form) body)) 96 97(defmacro Multiple-value-setq (vars form) 98 (list 'multiple-value-setq vars (list 'Multiple-value-list form))) 99 100(defmacro Multiple-value-prog1 (form &rest body) 101 (list 'prog1 form (list* 'let '((*mvalues-values* nil)) body))) 102 103 104;;; Routines for parsing keyword arguments. 105 106(defun build-klist (arglist keys &optional allow-others) 107 (let ((res (Multiple-value-call 'mapcar* 'cons (unzip-lists arglist)))) 108 (or allow-others 109 (let ((bad (set-difference (mapcar 'car res) keys))) 110 (if bad (error "Bad keywords: %s not in %s" bad keys)))) 111 res)) 112 113(defun extract-from-klist (klist key &optional def) 114 (let ((res (assq key klist))) (if res (cdr res) def))) 115 116(defun keyword-argument-supplied-p (klist key) 117 (assq key klist)) 118 119(defun elt-satisfies-test-p (item elt klist) 120 (let ((test-not (cdr (assq ':test-not klist))) 121 (test (cdr (assq ':test klist))) 122 (key (cdr (assq ':key klist)))) 123 (if key (setq elt (funcall key elt))) 124 (if test-not (not (funcall test-not item elt)) 125 (funcall (or test 'eql) item elt)))) 126 127 128;;; Rounding functions with old-style multiple value returns. 129 130(defun cl-floor (a &optional b) (Values-list (floor* a b))) 131(defun cl-ceiling (a &optional b) (Values-list (ceiling* a b))) 132(defun cl-round (a &optional b) (Values-list (round* a b))) 133(defun cl-truncate (a &optional b) (Values-list (truncate* a b))) 134 135(defun safe-idiv (a b) 136 (let* ((q (/ (abs a) (abs b))) 137 (s (* (signum a) (signum b)))) 138 (Values q (- a (* s q b)) s))) 139 140 141;; Internal routines. 142 143(defun pair-with-newsyms (oldforms) 144 (let ((newsyms (mapcar (function (lambda (x) (gensym))) oldforms))) 145 (Values (mapcar* 'list newsyms oldforms) newsyms))) 146 147(defun zip-lists (evens odds) 148 (mapcan 'list evens odds)) 149 150(defun unzip-lists (list) 151 (let ((e nil) (o nil)) 152 (while list 153 (setq e (cons (car list) e) o (cons (cadr list) o) list (cddr list))) 154 (Values (nreverse e) (nreverse o)))) 155 156(defun reassemble-argslists (list) 157 (let ((n (apply 'min (mapcar 'length list))) (res nil)) 158 (while (>= (setq n (1- n)) 0) 159 (setq res (cons (mapcar (function (lambda (x) (elt x n))) list) res))) 160 res)) 161 162(defun duplicate-symbols-p (list) 163 (let ((res nil)) 164 (while list 165 (if (memq (car list) (cdr list)) (setq res (cons (car list) res))) 166 (setq list (cdr list))) 167 res)) 168 169 170;;; Setf internals. 171 172(defun setnth (n list x) 173 (setcar (nthcdr n list) x)) 174 175(defun setnthcdr (n list x) 176 (setcdr (nthcdr (1- n) list) x)) 177 178(defun setelt (seq n x) 179 (if (consp seq) (setcar (nthcdr n seq) x) (aset seq n x))) 180 181 182;;; Functions omitted: case-clausify, check-do-stepforms, check-do-endforms, 183;;; extract-do-inits, extract-do[*]-steps, select-stepping-forms, 184;;; elt-satisfies-if[-not]-p, with-keyword-args, mv-bind-clausify, 185;;; all names with embedded `$'. 186 187 188(provide 'cl-compat) 189 190;;; cl-compat.el ends here 191 192