diff options
| author | Mattias Engdegård <mattiase@acm.org> | 2019-04-09 16:56:37 +0200 |
|---|---|---|
| committer | Eli Zaretskii <eliz@gnu.org> | 2019-04-09 19:10:47 +0300 |
| commit | 00a2d57adfe78bd137cd9458d9133f9c825b7d75 (patch) | |
| tree | 4dad9e9ff64daa86ca69a9ae5ffedf44c7de4d23 | |
| parent | a5da653319a3018074debfc7b4fdd90ac7ea838c (diff) | |
| download | emacs-00a2d57adfe78bd137cd9458d9133f9c825b7d75.tar.gz | |
Clarify the TESTFN argument to `alist-get'
* lisp/subr.el (alist-get):
Rephrase the initial text to clarify the meaning of the TESTFN argument.
It's an equality predicate, not a look-up function (Bug#35206).
(cherry picked from commit c81465580fe262f28ce47502c00f4afcbe3b8f8d)
| -rw-r--r-- | lisp/subr.el | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/lisp/subr.el b/lisp/subr.el index 44199a50754..54bee8a809f 100644 --- a/lisp/subr.el +++ b/lisp/subr.el @@ -752,9 +752,9 @@ Elements of ALIST that are not conses are ignored." alist) (defun alist-get (key alist &optional default remove testfn) - "Return the value associated with KEY in ALIST. + "Find the first element of ALIST whose `car' equals KEY and return its `cdr'. If KEY is not found in ALIST, return DEFAULT. -Use TESTFN to lookup in the alist if non-nil. Otherwise, use `assq'. +Equality with KEY is tested by TESTFN, defaulting to `eq'. This is a generalized variable suitable for use with `setf'. When using it to set a value, optional argument REMOVE non-nil |