From: Kim F. Storm Date: Thu, 21 Apr 2005 23:46:49 +0000 (+0000) Subject: (Symbol Plists): Remove safe-get, as get is now safe. X-Git-Tag: ttn-vms-21-2-B4~839 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=24f004ca8218d528c21db1156f6428ffe37caa88;p=emacs.git (Symbol Plists): Remove safe-get, as get is now safe. (Other Plists): Remove safe-plist-get, as plist-get is now safe. --- diff --git a/lispref/symbols.texi b/lispref/symbols.texi index 2c81cb9493c..9f59ad1f02d 100644 --- a/lispref/symbols.texi +++ b/lispref/symbols.texi @@ -496,8 +496,6 @@ This function finds the value of the property named @var{property} in @var{symbol}'s property list. If there is no such property, @code{nil} is returned. Thus, there is no distinction between a value of @code{nil} and the absence of the property. -A @code{wrong-type-argument} error may be signaled if @var{symbol} -has a malformed property list. The name @var{property} is compared with the existing property names using @code{eq}, so any object is a legitimate property. @@ -505,12 +503,6 @@ using @code{eq}, so any object is a legitimate property. See @code{put} for an example. @end defun -@defun safe-get symbol property -This function finds the value of the property named @var{property} in -@var{symbol}'s property list. Unlike @code{get}, it just returns -@code{nil} if @var{symbol} has a malformed property list. -@end defun - @defun put symbol property value This function puts @var{value} onto @var{symbol}'s property list under the property name @var{property}, replacing any previous property value. @@ -536,9 +528,7 @@ that are stored in places other than symbols: @defun plist-get plist property This returns the value of the @var{property} property -stored in the property list @var{plist}. -A @code{wrong-type-argument} error may be signaled if @var{plist} is -not a valid property list. For example, +stored in the property list @var{plist}. For example, @example (plist-get '(foo 4) 'foo) @@ -548,16 +538,12 @@ not a valid property list. For example, (plist-get '(foo 4 bad) 'bar) @result{} @code{wrong-type-argument} error @end example -@end defun -@defun safe-plist-get plist property -This returns the value of the @var{property} property -stored in the property list @var{plist}. Unlike @code{plist-get}, it -accepts a malformed @var{plist} argument and always returns @code{nil} +It accepts a malformed @var{plist} argument and always returns @code{nil} if @var{property} is not found in the @var{plist}. For example, @example -(safe-plist-get '(foo 4 bad) 'bar) +(plist-get '(foo 4 bad) 'bar) @result{} nil @end example @end defun