generate for generators

Generate a list of values by successively invoking a closure.

Signature

> generate {flags} (initial) (closure)

Parameters

  • initial: initial value
  • closure: generator function

Input/output types:

inputoutput
list<any>list<any>
nothinglist<any>

Examples

Generate a sequence of numbers

> generate 0 {|i| if $i <= 10 { {out: $i, next: ($i + 2)} }}
╭───┬────╮
 0   0 
 1   2 
 2   4 
 3   6 
 4   8 
 5  10 
╰───┴────╯

Generate a stream of fibonacci numbers

> generate [0, 1] {|fib| {out: $fib.0, next: [$fib.1, ($fib.0 + $fib.1)]} } | first 10
╭───┬────╮
 0   0 
 1   1 
 2   1 
 3   2 
 4   3 
 5   5 
 6   8 
 7  13 
 8  21 
 9  34 
╰───┴────╯

Notes

The generator closure accepts a single argument and returns a record containing two optional keys: 'out' and 'next'. Each invocation, the 'out' value, if present, is added to the stream. If a 'next' key is present, it is used as the next argument to the closure, otherwise generation stops.