[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/symbols.texi
From: |
Kim F . Storm |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/symbols.texi |
Date: |
Thu, 21 Apr 2005 19:46:49 -0400 |
Index: emacs/lispref/symbols.texi
diff -c emacs/lispref/symbols.texi:1.26 emacs/lispref/symbols.texi:1.27
*** emacs/lispref/symbols.texi:1.26 Tue Apr 19 09:11:51 2005
--- emacs/lispref/symbols.texi Thu Apr 21 23:46:49 2005
***************
*** 496,503 ****
@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.
--- 496,501 ----
***************
*** 505,516 ****
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.
--- 503,508 ----
***************
*** 536,544 ****
@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,
@example
(plist-get '(foo 4) 'foo)
--- 528,534 ----
@defun plist-get plist property
This returns the value of the @var{property} property
! stored in the property list @var{plist}. For example,
@example
(plist-get '(foo 4) 'foo)
***************
*** 548,563 ****
(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}
if @var{property} is not found in the @var{plist}. For example,
@example
! (safe-plist-get '(foo 4 bad) 'bar)
@result{} nil
@end example
@end defun
--- 538,549 ----
(plist-get '(foo 4 bad) 'bar)
@result{} @code{wrong-type-argument} error
@end example
! 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
! (plist-get '(foo 4 bad) 'bar)
@result{} nil
@end example
@end defun