summaryrefslogtreecommitdiffstats
path: root/txr.1
diff options
context:
space:
mode:
Diffstat (limited to 'txr.1')
-rw-r--r--txr.119
1 files changed, 18 insertions, 1 deletions
diff --git a/txr.1 b/txr.1
index ce6c7d64..75234425 100644
--- a/txr.1
+++ b/txr.1
@@ -33403,10 +33403,11 @@ is returned.
(partition* "abcd" '(0 1 2 3)) -> nil
.brev
-.coNP Functions @ find and @ find-if
+.coNP Functions @, find @ find-if and @ find-true
.synb
.mets (find < key < sequence >> [ testfun <> [ keyfun ]])
.mets (find-if < predfun >> { sequence | << hash } <> [ keyfun ])
+.mets (find-true < predfun >> { sequence | << hash } <> [ keyfun ])
.syne
.desc
The
@@ -33415,6 +33416,12 @@ and
.code find-if
functions search through a sequence for an item which
matches a key, or satisfies a predicate function, respectively.
+The
+.code find-true
+function is a variant of
+.code find-if
+which returns the value of the predicate function, instead
+of the item.
The
.meta keyfun
@@ -33475,6 +33482,16 @@ of which are the hash values. If the caller doesn't specify a
.meta keyfun
then these cells are taken as their keys.
+The
+.code find-true
+funtion's argument conventions and search semantics are identical to those of
+.codn find-if ,
+but the return value is different. Instead of returning the found item,
+.code find-true
+returns the value which
+.meta predfun
+returned for the found item's key.
+
.coNP Functions @ rfind and @ rfind-if
.synb
.mets (rfind < key < sequence >> [ testfun <> [ keyfun ]])