[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs-26 00a2d57: Clarify the TESTFN argument to `alist-ge
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] emacs-26 00a2d57: Clarify the TESTFN argument to `alist-get' |
Date: |
Tue, 9 Apr 2019 12:12:00 -0400 (EDT) |
branch: emacs-26
commit 00a2d57adfe78bd137cd9458d9133f9c825b7d75
Author: Mattias EngdegÄrd <address@hidden>
Commit: Eli Zaretskii <address@hidden>
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)
---
lisp/subr.el | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/lisp/subr.el b/lisp/subr.el
index 44199a5..54bee8a 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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] emacs-26 00a2d57: Clarify the TESTFN argument to `alist-get',
Eli Zaretskii <=