XMATCH
Searches for a value in a one-dimensional array and returns the relative position of the item.
XMATCH outperforms function MATCH as it allows searches according to the search mode.
XMATCH(Lookup; Array [; MatchType [; SearchMode ] ] )
Lookup: The value of any type to search for in Array.
Array: is the reference of the array or range to search.
MatchType: (optional) specifies the match type. Values can be:
-
0: exact match (default). If Lookup value is not found and NotFound text is omitted, then return the #N/A error.
-
-1: attempt exact match. If Lookup value is not found, then return the next smaller item.
-
1: attempt exact match. If Lookup value is not found, then return the next larger item.
-
2: a wildcard match where characters *, ?, and ~ have special meanings.
SearchMode: (optional) specifies the search mode to use.
The function is always case insensitive, independent from the setting of Case sensitive checkbox in - .
-
1: returns the first occurrence starting from the first item of Array (default).
-
-1: reverse search. Returns the first occurrence starting from the last item of Array.
-
2: binary search that relies on Array being sorted in ascending order. If not sorted, invalid results will be returned.
-
-2: binary search that relies on Array being sorted in descending order. If not sorted, invalid results will be returned.
Any of the optional arguments can be omitted. An optional argument is required to be preceded by the preceding separators.
Suppose we have built a small database table occupying the cell range A1:DO4 and containing basic information about 118 chemical elements. The first column contains the row headings “Element”, “Symbol”, “Atomic Number”, and “Relative Atomic Mass”. Subsequent columns contain the relevant information for each of the elements, ordered left to right by atomic number. For example, cells B1:B4 contain “Hydrogen”, “H”, “1” and “1.008”, while cells DO1:DO4 contain “Oganesson”, “Og”, “118”, and “294”.
|
A
|
B
|
C
|
D
|
...
|
DO
|
1
|
Element
|
Hidrogen
|
Heli
|
Liti
|
...
|
Oganessó
|
2
|
Símbol
|
H
|
He
|
Li
|
...
|
Og
|
3
|
Nombre atòmic
|
1
|
2
|
3
|
...
|
118
|
4
|
Massa atòmica relativa
|
1.008
|
4.0026
|
6.94
|
...
|
294
|
=XMATCH("Atomic Number",A1:A4) returns 3, the third line of the A1:A4 array.
=XMATCH("Li",A2:DO2) returns 4, the fourth column of the A2:DO2 array.
This function is available since LibreOfficeDev 24.8.
This function is not part of the Open Document Format for Office Applications (OpenDocument) Version 1.3. Part 4: Recalculated Formula (OpenFormula) Format standard. The name space is
COM.MICROSOFT.XMATCH