MAP

maps lambda over array values · from excel · excel: verified match · sheets: verified match

signature

MAP(array, lambda)

returns: array

argumentrequired
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 =MAP(A1:A3, LAMBDA(v, v * 2)) 20

errors

error values observed from the engine — each with a call that produces it.

errorproduced by
#VALUE! =MAP(A1:A2, B1:B1, LAMBDA(a, b, a + b))
#ERROR! =MAP(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