FILTER
returns the rows or columns of a range that meet a condition · from excel · excel: verified match · sheets: verified match
signature
FILTER(array, include, [if_empty])
returns: array
| argument | required |
|---|---|
| array | required |
| include | required |
| if_empty | optional |
examples
formula and result, taken from the engine's own test suite — every result below is asserted in CI, not written by hand.
| A | B | |
|---|---|---|
| 1 | 10 | 2 |
| 2 | 20 | 4 |
| 3 | 30 | 6 |
| 4 | 40 | 8 |
| 5 | 50 | 10 |
fx
=FILTER(A1:B5, B1:B5>3, "none") 20 errors
error values observed from the engine — each with a call that produces it.
| error | produced by |
|---|---|
| #CALC! | =FILTER(A1:B2,{FALSE,FALSE}) |
| #ERROR! | =FILTER(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