MATCH
returns position of value in a range
signature
MATCH(lookup_value, lookup_array, [match_type])
returns: number
| argument | required |
|---|---|
| lookup_value | required |
| lookup_array | required |
| match_type | 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 | |
|---|---|
| 1 | 10 |
| 2 | 20 |
| 3 | 30 |
| 4 | 40 |
| 5 | 50 |
fx
=MATCH(30, A1:A10, 0) 3 errors
error values observed from the engine — each with a call that produces it.
| error | produced by |
|---|---|
| #N/A | =MATCH(100,{24,43.5,52.8,69},0) |
| #ERROR! | =MATCH(1,{1,2;3,4},0) |
related
- ADDRESS returns a cell address as text from row and column numbers
- AREAS returns the number of areas in a reference
- HLOOKUP searches first row and returns matching value
- INDEX returns value at row and column in range
- INDIRECT returns reference specified by text string
- LOOKUP looks up value in one-row or one-column range