mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-11-24 07:20:37 +00:00
Code Issues Releases Activity

(Symbol Plists): Remove safe-get, as get is now safe.

Browse Source 
(Other Plists): Remove safe-plist-get, as plist-get is now safe.
This commit is contained in:
Kim F. Storm 2005-04-21 23:46:49 +00:00
parent 1ba52906b4
commit 24f004ca82
1 changed files with 3 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
lispref/symbols.texi
View File

@ -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