XMATCH

XMATCH関数は、配列またはセル範囲内で指定された項目を検索し、項目の相対的な位置を返します。 XMATCH を使用して、リスト内の項目の位置を検索します。

XMATCH 関数は、近似一致、部分一致 (* 、? などのワイルドカード文字の使用)および完全一致をサポートしています。

構文

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

引数

本関数の有効な引数は次のとおりです。

引数	説明
lookup_value	参照値。
lookup_array	検索する配列または範囲。
[match_mode]	（オプション）次の値に従って、一致の種類を指定します。 0 - 完全一致。見つからない場合は、#N/A が返されます。これが既定の設定です。 -1 - 完全一致。見つからない場合は、次の小さなアイテムが返されます。 1 - 完全一致。見つからない場合は、次の大きなアイテムが返されます。 2 - *、?、および ? が特別な意味を持つワイルドカードの一致。
[search_mode]	（オプション）次の値に従って、検索モードを指定します。 0 - 一致したすべての値が返される「すべて検索」モードを実行します。 [このモードはExcelでは使用できません。] 1 - 先頭の項目から検索を実行します。これが既定の設定です。 -1 - 末尾の項目から逆方向に検索を実行します。 2 - 昇順で替えられたlookup_array引数に依存するバイナリ検索を実行します。 -2 - 降順で替えられたlookup_array引数に依存するバイナリ検索を実行します。

解説

XMATCH関数は、垂直配列と水平配列の両方で動作します。参照値が見つからない場合XMATCH関数は#N/Aエラーを返します。ワイルドカード一致モードとバイナリ検索モードを同時に使用すると、#VALUE! を返します。

データ型

数値データを受け取り、範囲またはテーブル内の値を検索し、複数のアイテムを持つ配列を返します。

サンプル

次のコードは、XMATCH関数の使用法を示します。

$(document).ready(function () {
    // Spreadを初期化します
    var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });
    // 動的配列のサポートを有効にします
    spread.options.allowDynamicArray = true;
    // activeSheetを取得します
    var sheet = spread.getSheet(0);
    // 列の幅を設定します
    sheet.setColumnWidth(6, 160);

    // 式を作成します
    var formula_Exact = '=XMATCH(G4,A5:A9)';
    var formula_Approx = '=XMATCH(G10,D5:D9,1)';
    var formula_MultipleValues = '=XMATCH({5,4,1},C5:C9)';

    // 値を設定します
    sheet.setValue(0, 6, 'Basic exact match');
    sheet.setValue(1, 6, formula_Exact);
    sheet.setValue(6, 6, 'Basic approximate match');
    sheet.setValue(7, 6, formula_Approx);
    sheet.setValue(12, 6, 'MultipleValues');
    sheet.setValue(13, 6, formula_MultipleValues);
    // データを作成します
    var data = [
        ["Movie", "Year", "Rank", "Sales"],
        ["Fargo", 1996, 5, 61],
        ["L.A. Confidential", 1997, 4, 126],
        ["The Sixth Sense", 1999, 1, 673],
        ["Toy Story", 1995, 2, 362],
        ["Unforgiven", 1992, 3, 159]
    ];
    // データを設定します
    sheet.setArray(3, 0, data);
    // 値を設定します
    sheet.setValue(3, 5, 'Movie');
    sheet.setValue(4, 5, 'Position');
    sheet.setValue(3, 6, 'Toy Story');
    // 式を設定します
    sheet.setFormula(4, 6, formula_Exact);

    // 値を設定します
    sheet.setValue(9, 5, 'Sales');
    sheet.setValue(10, 5, 'Position');
    sheet.setValue(9, 6, 400);
    // 式を設定します
    sheet.setFormula(10, 6, formula_Approx);

    // 値を設定します
    sheet.setValue(15, 5, 'Rank');
    sheet.setValue(16, 5, 'Position');
    sheet.setValue(15, 6, '{5,4,1}');
    // 式を設定します
    sheet.setFormula(16, 6, formula_MultipleValues);

});

XMATCH

構文

引数

解説

データ型

サンプル

関連トピック