X-Git-Url: http://repo.macrolet.net/gitweb/?a=blobdiff_plain;f=src%2Fcode%2Fsymbol.lisp;h=a32c85576813025bd613ca8b4cd1b9b8646e75d0;hb=9a241987c408980164f71237f7d840265302bbc1;hp=2ba65581e01e002b46f071e5eaf3f9c64073f5f9;hpb=02ce4b1b927f1312c300047bd5a0db6663a1d2c6;p=sbcl.git diff --git a/src/code/symbol.lisp b/src/code/symbol.lisp index 2ba6558..a32c855 100644 --- a/src/code/symbol.lisp +++ b/src/code/symbol.lisp @@ -17,70 +17,72 @@ (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." + (set symbol + (%primitive sb!c:make-other-immediate-type + 0 + sb!vm:unbound-marker-widetag)) + symbol) +;;; Return the built-in hash value for SYMBOL. +#!+(or x86 mips) ;; only backends for which a symbol-hash vop exists (defun symbol-hash (symbol) - #!+sb-doc - "Return the built-in hash value for symbol." (symbol-hash symbol)) -(defun symbol-function (variable) +;;; Compute the hash value for SYMBOL. +#!-(or x86 mips) +(defun symbol-hash (symbol) + (%sxhash-simple-string (symbol-name symbol))) + +(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)) + (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)) @@ -89,8 +91,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 @@ -143,9 +144,8 @@ (defun getf (place indicator &optional (default ())) #!+sb-doc - "Searches the property list stored in Place for an indicator EQ to Indicator. - If one is found, the corresponding value is returned, else the Default is - returned." + "Search the property list stored in Place for an indicator EQ to INDICATOR. + If one is found, return the corresponding value, else return DEFAULT." (do ((plist place (cddr plist))) ((null plist) default) (cond ((atom (cdr plist)) @@ -165,8 +165,8 @@ (defun get-properties (place indicator-list) #!+sb-doc - "Like GETF, except that Indicator-List is a list of indicators which will - be looked for in the property list stored in Place. Three values are + "Like GETF, except that INDICATOR-LIST is a list of indicators which will + be looked for in the property list stored in PLACE. Three values are returned, see manual for details." (do ((plist place (cddr plist))) ((null plist) (values nil nil nil)) @@ -198,7 +198,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*)))