Articles with the tag:
Close
Changelog
Close
Articles with the tag:
Close
Try in the cloud
Try in the cloud

XMATCH Function

The XMATCH function is one of the lookup and reference functions. It is used to return the relative position of an item in an array. By default, an exact match is required.

Syntax

XMATCH(lookup_value, lookup_array, [match_mode], [search_mode])

The XMATCH function has the following arguments:

Argument Description
lookup_value A value to search for.
lookup_array An array or range to search in.
match_mode An optional argument. The possible values are listed in the table below.
search_mode An optional argument. The possible values are listed in the table below.

The match_mode argument can be one of the following:

Value Description
0 Set by default. Returns the exact match; if there is no match, the “N/A” is returned instead.
-1 Returns the exact match; if there is none, the next smaller item is returned.
1 Returns the exact match; if there is none, the next larger item is returned.
2 A wildcard match.

The search_mode argument can be one of the following:

Value Description
1 Set by default. Starts a search at the first item.
-1 Starts a reverse search, i.e. at the last item.
2 Starts a binary search with the lookup_array sorted in ascending order. If not sorted, invalid results will be returned.
-2 Starts a binary search with the lookup_array sorted in descending order. If not sorted, invalid results will be returned.

Notes

Wildcard characters include the question mark (?) that matches a single character and the asterisk (*) that matches multiple characters. If you want to find a question mark or asterisk, type a tilde (~) before the character.

Please note that this is an array formula. To learn more, please read the Insert array formulas article.

How to apply the XMATCH function.

Examples

The figure below displays the result returned by the XMATCH function.

XMATCH Function

Return to previous page
Try now for free Try and make your decision No need to install anything
to see all the features in action