summaryrefslogtreecommitdiff
path: root/source/text/scalc/01/func_xmatch.xhp
blob: 5a8d32ca7fc9fa335242e4db5f05ecb7eaeaf7aa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
    <!--
    * This file is part of the LibreOffice project.
    *
    * This Source Code Form is subject to the terms of the Mozilla Public
    * License, v. 2.0. If a copy of the MPL was not distributed with this
    * file, You can obtain one at http://mozilla.org/MPL/2.0/.
    *
    -->

    <meta>
        <topic id="textscalc01func_xmatchxhp" indexer="include" status="PUBLISH">
        <title id="tit">XMATCH Function</title>
        <filename>/text/scalc/01/func_xmatch.xhp</filename>
    </topic>
</meta>
<body>
<bookmark branch="hid/SC_HID_FUNC_XMATCH_MS" id="bm_id501708280229180" localize="false"/>
<bookmark branch="index" id="bm_id361708283183878">
    <bookmark_value>XMATCH function</bookmark_value>
</bookmark>
<section id="xmatch">
    <h1 id="hd_id821708279355736"><variable id="h1"><link href="text/scalc/01/func_xmatch.xhp">XMATCH</link></variable></h1>
    <paragraph id="par_id581708279355738" role="paragraph">Searches for a value in an array or range of cells and returns the relative position of the item.</paragraph>
</section>
<embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/>
<paragraph role="code" id="par_id211708281649651">XMATCH(Lookup; Array [; MatchType; SearchMode ] )</paragraph>
<paragraph role="paragraph" id="par_id861708281340704"><emph>Lookup</emph>: The value of any type to search for in <emph>Array</emph>.</paragraph>
<paragraph role="paragraph" id="par_id831708281625340"><emph>Array</emph>: is the reference of the array or range to search.</paragraph>
<embed href="text/scalc/01/func_xlookup.xhp#matchmode"/>
<embed href="text/scalc/01/func_xlookup.xhp#searchmode"/>
<note id="par_id391708364611193">XMATCH outperforms function MATCH as it allows searches according to the search mode.</note>
<embed href="text/scalc/01/ful_func.xhp#func_head_example"/>
<embed href="text/scalc/01/func_xlookup.xhp#xfunc_example"/>
<paragraph role="paragraph" id="par_id31708356677157"><input>=XMATCH("Save", A2:A4, 0, 1)</input> returns 2, the second line of the A2:A4 range.</paragraph>
<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/>
<embed href="text/scalc/00/avail_release.xhp#24.8"/>
<embed href="text/scalc/01/common_func.xhp#notODFF"/>
<paragraph role="paragraph" id="par_id341640870986703" localize="false"><literal>COM.MICROSOFT.XMATCH</literal></paragraph>
<section id="relatedtopics">
    <paragraph role="paragraph" id="par_id71708365909272" localize="false"><embedvar href="text/scalc/01/func_xlookup.xhp#h1" markup="ignore"/></paragraph>
    <tip id="par_id701677016751508"><link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/XMATCH">XMATCH wiki page</link>.</tip>
</section>
</body>
</helpdocument>