SCAN
scans array with lambda keeping intermediates · from excel · excel: verified match · sheets: verified match
signature
SCAN(initial_value, array, lambda)
returns: array
| argument | required |
|---|---|
| initial_value | required |
| array | required |
| lambda | required |
examples
formula and result, taken from the engine's own test suite — every result below is asserted in CI, not written by hand.
| A | |
|---|---|
| 1 | 10 |
| 2 | 20 |
| 3 | 30 |
fx
=SCAN(0, A1:A3, LAMBDA(acc, v, acc + v)) 10 errors
error values observed from the engine — each with a call that produces it.
| error | produced by |
|---|---|
| #ERROR! | =SCAN(A2:A3) |
related
- ARRAY_CONSTRAIN truncates a range to at most the given rows and columns
- ARRAYFORMULA evaluates an expression across a range (this engine already spills, so it is a pass-through for sheets compatibility)
- ARRAYTOTEXT converts array to text representation
- BYCOL applies lambda to each column of array
- BYROW applies lambda to each row of array
- CHOOSECOLS returns the specified columns from an array