diff options
| author | Kim F. Storm | 2005-04-21 23:46:49 +0000 |
|---|---|---|
| committer | Kim F. Storm | 2005-04-21 23:46:49 +0000 |
| commit | 24f004ca8218d528c21db1156f6428ffe37caa88 (patch) | |
| tree | 59d93e69933473706d232374f23c1844a37f33d7 | |
| parent | 1ba52906b45d369f8770366f3d9ce8cc73919db1 (diff) | |
| download | emacs-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.texi | 20 |
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} |
| 497 | is returned. Thus, there is no distinction between a value of | 497 | is 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. |
| 499 | A @code{wrong-type-argument} error may be signaled if @var{symbol} | ||
| 500 | has a malformed property list. | ||
| 501 | 499 | ||
| 502 | The name @var{property} is compared with the existing property names | 500 | The name @var{property} is compared with the existing property names |
| 503 | using @code{eq}, so any object is a legitimate property. | 501 | using @code{eq}, so any object is a legitimate property. |
| @@ -505,12 +503,6 @@ using @code{eq}, so any object is a legitimate property. | |||
| 505 | See @code{put} for an example. | 503 | See @code{put} for an example. |
| 506 | @end defun | 504 | @end defun |
| 507 | 505 | ||
| 508 | @defun safe-get symbol property | ||
| 509 | This 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 |
| 515 | This function puts @var{value} onto @var{symbol}'s property list under | 507 | This function puts @var{value} onto @var{symbol}'s property list under |
| 516 | the property name @var{property}, replacing any previous property value. | 508 | the 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 |
| 538 | This returns the value of the @var{property} property | 530 | This returns the value of the @var{property} property |
| 539 | stored in the property list @var{plist}. | 531 | stored in the property list @var{plist}. For example, |
| 540 | A @code{wrong-type-argument} error may be signaled if @var{plist} is | ||
| 541 | not 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 | 542 | It accepts a malformed @var{plist} argument and always returns @code{nil} |
| 554 | This returns the value of the @var{property} property | ||
| 555 | stored in the property list @var{plist}. Unlike @code{plist-get}, it | ||
| 556 | accepts a malformed @var{plist} argument and always returns @code{nil} | ||
| 557 | if @var{property} is not found in the @var{plist}. For example, | 543 | if @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 |