aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKim F. Storm2005-04-21 23:46:49 +0000
committerKim F. Storm2005-04-21 23:46:49 +0000
commit24f004ca8218d528c21db1156f6428ffe37caa88 (patch)
tree59d93e69933473706d232374f23c1844a37f33d7
parent1ba52906b45d369f8770366f3d9ce8cc73919db1 (diff)
downloademacs-24f004ca8218d528c21db1156f6428ffe37caa88.tar.gz
emacs-24f004ca8218d528c21db1156f6428ffe37caa88.zip
(Symbol Plists): Remove safe-get, as get is now safe.
(Other Plists): Remove safe-plist-get, as plist-get is now safe.
-rw-r--r--lispref/symbols.texi20
1 files changed, 3 insertions, 17 deletions
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
496@var{symbol}'s property list. If there is no such property, @code{nil} 496@var{symbol}'s property list. If there is no such property, @code{nil}
497is returned. Thus, there is no distinction between a value of 497is returned. Thus, there is no distinction between a value of
498@code{nil} and the absence of the property. 498@code{nil} and the absence of the property.
499A @code{wrong-type-argument} error may be signaled if @var{symbol}
500has a malformed property list.
501 499
502The name @var{property} is compared with the existing property names 500The name @var{property} is compared with the existing property names
503using @code{eq}, so any object is a legitimate property. 501using @code{eq}, so any object is a legitimate property.
@@ -505,12 +503,6 @@ using @code{eq}, so any object is a legitimate property.
505See @code{put} for an example. 503See @code{put} for an example.
506@end defun 504@end defun
507 505
508@defun safe-get symbol property
509This function finds the value of the property named @var{property} in
510@var{symbol}'s property list. Unlike @code{get}, it just returns
511@code{nil} if @var{symbol} has a malformed property list.
512@end defun
513
514@defun put symbol property value 506@defun put symbol property value
515This function puts @var{value} onto @var{symbol}'s property list under 507This function puts @var{value} onto @var{symbol}'s property list under
516the property name @var{property}, replacing any previous property value. 508the property name @var{property}, replacing any previous property value.
@@ -536,9 +528,7 @@ that are stored in places other than symbols:
536 528
537@defun plist-get plist property 529@defun plist-get plist property
538This returns the value of the @var{property} property 530This returns the value of the @var{property} property
539stored in the property list @var{plist}. 531stored in the property list @var{plist}. For example,
540A @code{wrong-type-argument} error may be signaled if @var{plist} is
541not a valid property list. For example,
542 532
543@example 533@example
544(plist-get '(foo 4) 'foo) 534(plist-get '(foo 4) 'foo)
@@ -548,16 +538,12 @@ not a valid property list. For example,
548(plist-get '(foo 4 bad) 'bar) 538(plist-get '(foo 4 bad) 'bar)
549 @result{} @code{wrong-type-argument} error 539 @result{} @code{wrong-type-argument} error
550@end example 540@end example
551@end defun
552 541
553@defun safe-plist-get plist property 542It accepts a malformed @var{plist} argument and always returns @code{nil}
554This returns the value of the @var{property} property
555stored in the property list @var{plist}. Unlike @code{plist-get}, it
556accepts a malformed @var{plist} argument and always returns @code{nil}
557if @var{property} is not found in the @var{plist}. For example, 543if @var{property} is not found in the @var{plist}. For example,
558 544
559@example 545@example
560(safe-plist-get '(foo 4 bad) 'bar) 546(plist-get '(foo 4 bad) 'bar)
561 @result{} nil 547 @result{} nil
562@end example 548@end example
563@end defun 549@end defun