mirrors/janet
1
0
Fork 0
mirror of https://github.com/janet-lang/janet synced 2025-11-11 21:14:16 +00:00
Code Issues 1 Releases Wiki Activity

Tweak doc for mapcat, count, keep, all, some

Browse Source
This commit is contained in:
sogaiu
2025-04-04 21:56:31 +09:00
parent 363e32d455
commit e2cc8f2965
1 changed files with 46 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

59
src/boot/boot.janet
View File

@@ -1098,8 +1098,14 @@
res) res)
(defn mapcat (defn mapcat
``Map a function over every element in an array or tuple and ```
use `array/concat` to concatenate the results.`` Map a function `f` over every value in a data structure `ind`
and use `array/concat` to concatenate the results, but only if
no `inds` are provided. Multiple data structures can be handled
if each `inds` is a data structure and `f` is a function of
arity one more than the number of `inds`. The resulting array
has a length that is the shortest of `ind` and each of `inds`.
```
[f ind & inds] [f ind & inds]
(def res @[]) (def res @[])
(map-template :mapcat res f ind inds) (map-template :mapcat res f ind inds)
@@ -1116,18 +1122,30 @@
res) res)
(defn count (defn count
``Count the number of items in `ind` for which `(pred item)` ```
is true.`` Count the number of values in a data structure `ind` for which
applying `pred` yields a truthy value, but only if no `inds` are
provided. Multiple data structures can be handled if each `inds`
is a data structure and `pred` is a function of arity one more
than the number of `inds`. Note that `pred` is only applied to
values at indeces up to the largest index of the shortest of
`ind` and each of `inds`.
```
[pred ind & inds] [pred ind & inds]
(var res 0) (var res 0)
(map-template :count res pred ind inds) (map-template :count res pred ind inds)
res) res)
(defn keep (defn keep
``Given a predicate `pred`, return a new array containing the truthy results ```
of applying `pred` to each element in the indexed collection `ind`. This is Given a predicate `pred`, return a new array containing the
different from `filter` which returns an array of the original elements where truthy results of applying `pred` to each value in the data
the predicate is truthy.`` structure `ind`, but only if no `inds` are provided. Multiple
data structures can be handled if each `inds` is a data
structure and `pred` is a function of arity one more than the
number of `inds`. The resulting array has a length that is the
shortest of `ind` and each of `inds`.
```
[pred ind & inds] [pred ind & inds]
(def res @[]) (def res @[])
(map-template :keep res pred ind inds) (map-template :keep res pred ind inds)
@@ -2209,17 +2227,32 @@
ret) ret)
(defn all (defn all
``Returns true if `(pred item)` is truthy for every item in `ind`. ```
Otherwise, returns the first falsey result encountered. Returns true if applying `pred` to every value in a data
Returns true if `ind` is empty.`` structure `ind` results in only truthy values, but only if no
`inds` are provided. Multiple data structures can be handled
if each `inds` is a data structure and `pred` is a function
of arity one more than the number of `inds`. Returns the first
falsey result encountered. Note that `pred` is only called as
many times as the length of the shortest of `ind` and each of
`inds`. If `ind` or any of `inds` are empty, returns true.
```
[pred ind & inds] [pred ind & inds]
(var res true) (var res true)
(map-template :all res pred ind inds) (map-template :all res pred ind inds)
res) res)
(defn some (defn some
``Returns nil if `(pred item)` is false or nil for every item in `ind`. ```
Otherwise, returns the first truthy result encountered.`` Returns nil if applying `pred` to every value in a data
structure `ind` results in only falsey values, but only if no
`inds` are provided. Multiple data structures can be handled
if each `inds` is a data structure and `pred` is a function
of arity one more than the number of `inds`. Returns the first
truthy result encountered. Note that `pred` is only called as
many times as the length of the shortest of `ind` and each of
`inds`. If `ind` or any of `inds` are empty, returns nil.
```
[pred ind & inds] [pred ind & inds]
(var res nil) (var res nil)
(map-template :some res pred ind inds) (map-template :some res pred ind inds)