summaryrefslogtreecommitdiffstats
path: root/txr.1
diff options
context:
space:
mode:
Diffstat (limited to 'txr.1')
-rw-r--r--txr.130
1 files changed, 29 insertions, 1 deletions
diff --git a/txr.1 b/txr.1
index ce6f045f..5fbf346f 100644
--- a/txr.1
+++ b/txr.1
@@ -40109,7 +40109,7 @@ The specified
.meta pattern
is applied against every element of the sequence. The match is successful if
.meta pattern
-finds a matching element.
+matches at least one element.
Variables are extracted from the first matching which is found.
@@ -40125,6 +40125,34 @@ Variables are extracted from the first matching which is found.
-> (2 b)
.brev
+.coNP Pattern operator @ coll
+.synb
+.mets @(coll << pattern )
+.syne
+.desc
+The
+.code coll
+pattern operator requires the corresponding object to be a sequence.
+The specified
+.meta pattern
+is applied against every element of the sequence. The match is successful if
+.meta pattern
+matches at least one element.
+
+Variables are extracted from all matching elements, and collected into
+parallel lists, just like with the
+.code @(all)
+operator.
+
+.TP* Example:
+
+.verb
+ (when-match @(coll (x @a @b))
+ '((y 1 a) (x 2 b) (z 3 c) (x 4 d))
+ (list a b))
+ -> ((2 4) (b d))
+.brev
+
.coNP Pattern operators @ and and @ or
.synb
.mets @(and << pattern *)