Xw48W‖

DDESR‖XLOOKUP

yC7FC‖Searches for a value in an array and returns a reference to a cell or range of cells.

mekaB‖XLOOKUP function is a modern and flexible replacement for older functions like VLOOKUP, HLOOKUP, and LOOKUP. XLOOKUP supports approximate and exact matching, wildcards (* ?) or regular expressions for partial matches, and lookups in vertical or horizontal ranges. XLOOKUP can perform a reverse search and offers a fast binary search option when working with large datasets.

ebLBc‖Syntax

CY5Hu‖XLOOKUP( [Search criterion] ; Search Array ; Result Array [ ; [ Result if not found ] [ ; [Match Mode] [ ; Search Mode ] ] ] )

5W9TT‖Search criterion: (optional) The value of any type to search for in Array. If omitted, XLOOKUP returns blank cells it finds in Search Array.

JexuJ‖Search Array: is the reference of the array to search. Array must be a 1-dimensional array and must be contained in one sheet only.

EGAYg‖Result Array: is the reference of the array or range to return.

note

WKPAt‖If Result Array is a range of cells, the XLOOKUP function must be entered as an array formula.


sdzRc‖Result if not found: a text or cell content to return if the Lookup value is not found. If a valid match is not found and Result if not found is omitted, the function returns the #N/A error.

64MsW‖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


fHQrZ‖{=XLOOKUP("Atomic Number";A2:A4;A2:DO4)} returns the array

ERvum‖Atomic Number

1

2

3

...

118


tkRq7‖{=XLOOKUP("Helium";B1:DO1;B1:DO4)} returns the array

D5tG5‖Helium

He

2

4.0026


vaCSD‖{=XLOOKUP("Kryptonite";B1:DO1;B1:DO4;"Unknown element")} returns the array {"Unknown element","Unknown element","Unknown element","Unknown element"}.

XAFa7‖Technical information

tip

Lh98N‖This function is available since LibreOfficeDev 24.8.


2C7vt‖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.XLOOKUP