summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--txr.140
1 files changed, 36 insertions, 4 deletions
diff --git a/txr.1 b/txr.1
index 0135c79c..ec0a09b9 100644
--- a/txr.1
+++ b/txr.1
@@ -40805,9 +40805,10 @@ macro for deleting a place.
.SS* Permutations and Combinations
-.coNP Function @ perm
+.coNP Functions @ perm and @ permi
.synb
.mets (perm < seq <> [ len ])
+.mets (permi < seq <> [ len ])
.syne
.desc
The
@@ -40821,6 +40822,13 @@ The permutations do not use any element of
.meta seq
more than once.
+The
+.code permi
+function has identical argument semantics, but returns an iterator
+instead of a lazy list: an object meeting the same conventions
+as the return value of
+.codn iter-begin .
+
Argument
.metn len ,
if present, must be a positive integer, and
@@ -40851,9 +40859,10 @@ requires more items than are available.
The permutations are lexicographically ordered.
-.coNP Function @ rperm
+.coNP Functions @ rperm and @ rpermi
.synb
.mets (rperm < seq << len )
+.mets (rpermi < seq << len )
.syne
.desc
The
@@ -40868,6 +40877,13 @@ formed by items taken from
can appear more than
once in the permutations.
+The
+.code rpermi
+function has identical argument semantics, but returns an iterator
+instead of a lazy list: an object meeting the same conventions
+as the return value of
+.codn iter-begin .
+
The permutations which are returned are sequences of the same kind as
.metn seq .
@@ -40913,9 +40929,10 @@ That is to say, the permutations are lexicographically ordered.
(1 1) (1 2) (2 0) (2 1) (2 2))
.brev
-.coNP Function @ comb
+.coNP Functions @ comb and @ combi
.synb
.mets (comb < seq << len )
+.mets (combi < seq << len )
.syne
.desc
The
@@ -40933,6 +40950,13 @@ more than once. If
contains no duplicates, then
the combinations contain no duplicates.
+The
+.code combi
+function has identical argument semantics, but returns an iterator
+instead of a lazy list: an object meeting the same conventions
+as the return value of
+.codn iter-begin .
+
Argument
.meta len
must be a nonnegative integer, and
@@ -40971,9 +40995,10 @@ is a hash table.
(mappend* (op comb s) (range 0 (length s))))
.brev
-.coNP Function @ rcomb
+.coNP Functions @ rcomb and @ rcombi
.synb
.mets (rcomb < seq << len )
+.mets (rcombi < seq << len )
.syne
.desc
The
@@ -40988,6 +41013,13 @@ an element of
.meta seq
more than once.
+The
+.code rcombi
+function has identical argument semantics, but returns an iterator
+instead of a lazy list: an object meeting the same conventions
+as the return value of
+.codn iter-begin .
+
Argument
.meta len
must be a nonnegative integer, and