X-Git-Url: http://repo.macrolet.net/gitweb/?a=blobdiff_plain;f=src%2Fcode%2Fsymbol.lisp;h=557141b2b2e37b147ad5d28219a6199f0e5cafcc;hb=bfe145acc01eb7a43790173db4f08610ae9cb07a;hp=f2c1c0ccc13802a5dcb11653b6fbf4ca8df96e1a;hpb=7ef5ec93744c7cc1c7a0280e46f8b42b74353713;p=sbcl.git diff --git a/src/code/symbol.lisp b/src/code/symbol.lisp index f2c1c0c..557141b 100644 --- a/src/code/symbol.lisp +++ b/src/code/symbol.lisp @@ -17,78 +17,69 @@ (declaim (maybe-inline get %put getf remprop %putf get-properties keywordp)) -(defun symbol-value (variable) +(defun symbol-value (symbol) #!+sb-doc - "VARIABLE must evaluate to a symbol. This symbol's current special - value is returned." + "Return SYMBOL's current bound value." (declare (optimize (safety 1))) - (symbol-value variable)) + (symbol-value symbol)) -(defun boundp (variable) +(defun boundp (symbol) #!+sb-doc - "VARIABLE must evaluate to a symbol. Return NIL if this symbol is - unbound, T if it has a value." - (boundp variable)) + "Return non-NIL if SYMBOL is bound to a value." + (boundp symbol)) -(defun set (variable new-value) +(defun set (symbol new-value) #!+sb-doc - "VARIABLE must evaluate to a symbol. This symbol's special value cell is - set to the specified new value." - (declare (type symbol variable)) - (about-to-modify variable) - (%set-symbol-value variable new-value)) + "Set SYMBOL's value cell to NEW-VALUE." + (declare (type symbol symbol)) + (about-to-modify-symbol-value symbol) + (%set-symbol-value symbol new-value)) (defun %set-symbol-value (symbol new-value) (%set-symbol-value symbol new-value)) -(defun makunbound (variable) +(defun makunbound (symbol) #!+sb-doc - "VARIABLE must evaluate to a symbol. This symbol is made unbound, - removing any value it may currently have." - (set variable - (%primitive sb!c:make-other-immediate-type 0 sb!vm:unbound-marker-type)) - variable) + "Make SYMBOL unbound, removing any value it may currently have." + (with-single-package-locked-error (:symbol symbol "unbinding the symbol ~A") + (set symbol + (%primitive sb!c:make-other-immediate-type + 0 + sb!vm:unbound-marker-widetag)) + symbol)) -#!+(or x86 mips) ;; only backends for which a symbol-hash vop exists +;;; Return the built-in hash value for SYMBOL. (defun symbol-hash (symbol) - #!+sb-doc - "Return the built-in hash value for symbol." (symbol-hash symbol)) -#!-(or x86 mips) -(defun symbol-hash (symbol) - #!+sb-doc - "Return the built-in hash value for symbol." - (%sxhash-simple-string (symbol-name symbol))) - - -(defun symbol-function (variable) +(defun symbol-function (symbol) #!+sb-doc - "VARIABLE must evaluate to a symbol. This symbol's current definition - is returned. Settable with SETF." - (raw-definition variable)) + "Return SYMBOL's current function definition. Settable with SETF." + (%coerce-name-to-fun symbol)) -(defun fset (symbol new-value) +(defun (setf symbol-function) (new-value symbol) (declare (type symbol symbol) (type function new-value)) - (setf (raw-definition symbol) new-value)) + (with-single-package-locked-error + (:symbol symbol "setting the symbol-function of ~A") + (setf (%coerce-name-to-fun symbol) new-value))) -(defun symbol-plist (variable) +(defun symbol-plist (symbol) #!+sb-doc - "Return the property list of a symbol." - (symbol-plist variable)) + "Return SYMBOL's property list." + (symbol-plist symbol)) (defun %set-symbol-plist (symbol new-value) (setf (symbol-plist symbol) new-value)) -(defun symbol-name (variable) +(defun symbol-name (symbol) #!+sb-doc - "Return the print name of a symbol." - (symbol-name variable)) + "Return SYMBOL's name as a string." + (symbol-name symbol)) -(defun symbol-package (variable) +(defun symbol-package (symbol) #!+sb-doc - "Return the package a symbol is interned in, or NIL if none." - (symbol-package variable)) + "Return the package SYMBOL was interned in, or NIL if none." + (symbol-package symbol)) (defun %set-symbol-package (symbol package) (declare (type symbol symbol)) @@ -97,8 +88,7 @@ (defun make-symbol (string) #!+sb-doc "Make and return a new symbol with the STRING as its print name." - #!-gengc (make-symbol string) - #!+gengc (%make-symbol (random most-positive-fixnum) string)) + (make-symbol string)) (defun get (symbol indicator &optional (default nil)) #!+sb-doc @@ -156,8 +146,11 @@ (do ((plist place (cddr plist))) ((null plist) default) (cond ((atom (cdr plist)) - (error "~S is a malformed property list." - place)) + (error 'simple-type-error + :format-control "malformed property list: ~S." + :format-arguments (list place) + :datum (cdr plist) + :expected-type 'cons)) ((eq (car plist) indicator) (return (cadr plist)))))) @@ -178,8 +171,11 @@ (do ((plist place (cddr plist))) ((null plist) (values nil nil nil)) (cond ((atom (cdr plist)) - (error "~S is a malformed proprty list." - place)) + (error 'simple-type-error + :format-control "malformed property list: ~S." + :format-arguments (list place) + :datum (cdr plist) + :expected-type 'cons)) ((memq (car plist) indicator-list) (return (values (car plist) (cadr plist) plist)))))) @@ -205,7 +201,7 @@ (defun keywordp (object) #!+sb-doc - "Returns true if Object is a symbol in the keyword package." + "Return true if Object is a symbol in the \"KEYWORD\" package." (and (symbolp object) (eq (symbol-package object) *keyword-package*)))