summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorEarl Hyatt <okamsn@protonmail.com>2021-08-14 14:17:55 +0200
committerLars Ingebrigtsen <larsi@gnus.org>2021-08-14 14:17:55 +0200
commita8a3fd8f8e27089ac46bf98e534529ff03f679a5 (patch)
treefc13287c6528608eaf6ff95c3bc09285650e8cb1 /doc
parentc58f8dda2b2282302cf47ef3e7df6523bde606f5 (diff)
downloademacs-a8a3fd8f8e27089ac46bf98e534529ff03f679a5.tar.gz
Add macro `seq-setq`.
* doc/lispref/sequences.texi (seq-setq): Document this macro. * test/lisp/emacs-lisp/seq-tests.el (test-seq-setq): Test this macro (bug#50053).
Diffstat (limited to 'doc')
-rw-r--r--doc/lispref/sequences.texi17
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/lispref/sequences.texi b/doc/lispref/sequences.texi
index 20816ce8ca2..257f5d162ea 100644
--- a/doc/lispref/sequences.texi
+++ b/doc/lispref/sequences.texi
@@ -1128,6 +1128,23 @@ assigned to variables as if by @code{setq} instead of as in a
@end example
@end defmac
+@defmac seq-setq var-sequence val-sequence
+@cindex sequence destructuring
+ This macro works similarly to @code{seq-let}, except that values are
+assigned to variables as if by @code{setq} instead of as in a
+@code{let} binding.
+
+@example
+@group
+(let ((a nil)
+ (b nil))
+ (seq-setq (_ a _ b) '(1 2 3 4))
+ (list a b))
+@result{} (2 4)
+@end group
+@end example
+@end defmac
+
@defun seq-random-elt sequence
This function returns an element of @var{sequence} taken at random.