GAX24‖

Y5Xci‖XMATCH

8GYav‖Searches for a value in a one-dimensional array and returns the relative position of the item.

qJsbC‖XMATCH outperforms function MATCH as it allows searches according to the search mode.

ebLBc‖Syntax

bzbma‖XMATCH(Search criterion; Search Array [; Match Mode [; Search Mode ] ] )

jkHsQ‖Search criterion: The value of any type to search for in Search Array.

c2hbH‖Search Array: is the reference of the array or range to search.

HDMeD‖Match Mode: (optional) specifies the match type. Values can be:

CFgfx‖Search Mode: (optional) specifies the search mode to use.

warning

hMFJt‖Match Mode values 2 and 3 cannot be combined with binary search (Search Mode value 2 or -2).


note

s37P8‖Any of the optional arguments can be omitted. An optional argument requires all preceding separators to be present.


GAZG2‖Examples

vwqHz‖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

eAMVa‖Element

BcKD5‖Hydrogen

ACHPj‖Helium

7YEmL‖Lithium

...

Y3c6z‖Oganesson

2

4H4fa‖Symbol

H

He

Li

...

Og

3

jVBoy‖Atomic Number

1

2

3

...

118

4

WjrrE‖Relative Atomic Mass

1.008

4.0026

6.94

...

294


qBfiv‖=XMATCH("Atomic Number"; A1:A4) returns 3, the third line of the A1:A4 array.

LU7T5‖=XMATCH("Li"; A2:DO2) returns 4, the fourth column of the A2:DO2 array.

XAFa7‖Technical information

tip

Lh98N‖This function is available since LibreOfficeDev 24.8.


7AVhU‖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