XLOOKUP

XLOOKUP在垂直和水平单元格区域中执行查找，并支持近似匹配、部分匹配(使用通配符，如*、?等)和精确匹配。默认情况下，XLOOKUP函数返回精确匹配的结果。

相对于其他查找函数(如VLOOKUP、HLOOKUP和lookup等)，XLOOKUP函数更加灵活和强大。下面列出了使用XLOOKUP函数代替其他查找函数的更多好处:

• 用户可以使用XLOOKUP函数在查找值的左边或右边查找数据。
• 用户可以使用XLOOKUP函数从表中检索数据。
• 用户可以使用XLOOKUP函数从多个列返回结果。
• XLOOKUP函数可以处理垂直和水平数据。
• XLOOKUP函数还可以用于从第一个值或最后一个值开始搜索数据(反向查找)。
• XLOOKUP函数返回一个区域而不仅仅是一个值，而且还可以处理泛型数组。

例如，通过使用XLOOKUP函数，用户可以根据产品ID确定产品的价格，在一列中查找匹配的税率，根据员工ID搜索员工姓名，并在使用表格时执行许多其他搜索操作。

语法

XLOOKUP (lookup_value, lookup_array, return_array, [if_not_found], [match_mode], [search_mode])

参数

这个函数有以下参数:

备注

XLOOKUP函数与spreadsheets同时工作时，以下几点必须记住:

• 如果没有找到查找值，XLOOKUP函数将返回#N/A错误。
• 要获得有效结果，lookup_array参数的维度必须与return_array参数兼容，否则XLOOKUP函数将返回#VALUE!错误。

数据类型

接收数字数据。查找区域或表中的值。返回具有多个项的数组。

示例

下面的gif显示了XLOOKUP函数的基本用法。

下面的代码片段描述了XLOOKUP函数的基本用法。在本例中，XLOOKUP用于根据影片的精确匹配检索排名。

$(document).ready(function () {
    //初始化spread
    var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });
    // 启动动态数组支持
    spread.options.allowDynamicArray = true;
    // 创建样式
    var style = new GC.Spread.Sheets.Style();
    style.font = "bold 12px Arial";
    style.foreColor = "black";
    style.backColor = "#EDFDF4";
    style.hAlign = GC.Spread.Sheets.HorizontalAlign.center;
    style.vAlign = GC.Spread.Sheets.VerticalAlign.center;

    // 创建样式
    var formulaStyle = new GC.Spread.Sheets.Style();
    formulaStyle.font = "bold 12px Arial";
    formulaStyle.foreColor = "black";
    formulaStyle.backColor = "#D3F0E0";
    formulaStyle.vAlign = GC.Spread.Sheets.VerticalAlign.center;


    // 获取sheet1
    var sheet1 = spread.getSheet(0);
    //设置列宽
    sheet1.setColumnWidth(6, 180);
    // 创建公式
    var formula_Exact = '=XLOOKUP(G4,A5:A9,C5:C9)';
    // 设置值
    sheet1.setValue(0, 6, 'Basic exact match');
    sheet1.setValue(1, 6, formula_Exact);
    // 创建数据
    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]
    ];
    // 设置数据
    sheet1.setArray(3, 0, data);
    // 设置值
    sheet1.setValue(3, 5, 'Movie');
    sheet1.setValue(4, 5, 'Sales');
    sheet1.setValue(3, 6, 'Toy Story');
    // 设置公式
    sheet1.setFormula(4, 6, formula_Exact);

    // 设置样式
    for (var i = 0; i < 4; i++) {
        sheet1.setStyle(3, i, style, GC.Spread.Sheets.SheetArea.viewport);
    }
    sheet1.setStyle(3, 5, style, GC.Spread.Sheets.SheetArea.viewport);
    sheet1.setStyle(4, 5, style, GC.Spread.Sheets.SheetArea.viewport);
    sheet1.setStyle(0, 6, formulaStyle, GC.Spread.Sheets.SheetArea.viewport);
    sheet1.setStyle(1, 6, formulaStyle, GC.Spread.Sheets.SheetArea.viewport);
});

下面的gif显示了SUM和XLOOKUP函数一起对两个区域内的所有值进行求和。

下面的代码片段描述了SUM和XLOOKUP函数一起使用的情况。

$(document).ready(function () {
    //初始化spread
    var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });
    // 启用动态数组支持
    spread.options.allowDynamicArray = true;

    // 获取sheet7
    var sheet7 = spread.getSheet(0);

    // 设置文本
    sheet1.setValue(1, 1, 'XLOOKUP return reference');
    sheet1.setValue(2, 1, '=SUM(XLOOKUP(B6,B9:B13,E9:E13):XLOOKUP(C6,B9:B13,E9:E13))');
    sheet1.addSpan(1, 1, 1, 3, GC.Spread.Sheets.SheetArea.viewport);
    sheet1.addSpan(2, 1, 1, 7, GC.Spread.Sheets.SheetArea.viewport);

    sheet1.setValue(4, 1, 'Start');
    sheet1.setValue(4, 2, 'End');
    sheet1.setValue(4, 3, 'Total');
    sheet1.setValue(5, 1, 'Grape');
    sheet1.setValue(5, 2, 'Banana');

    // 创建数据
    var data = [
        ["Product", "Quantiy", "Price", "Total"],
        ["Apple", 23, 0.52, 11.9],
        ["Grape", 98, 0.77, 75.28],
        ["Pear", 75, 0.24, 18.16],
        ["Banana", 95, 0.18, 17.25],
        ["Cherry", 42, 0.16, 6.8]
    ];
    // 设置数据
    sheet7.setArray(7, 1, data);
    // 设置公式
    sheet7.setFormula(5, 3, "=SUM(XLOOKUP(B6,B9:B13,E9:E13):XLOOKUP(C6,B9:B13,E9:E13))");

    // 设置样式
    for (var i = 1; i < 5; i++) {
        sheet7.setStyle(7, i, style, GC.Spread.Sheets.SheetArea.viewport);
    }
    for (var i = 1; i < 4; i++) {
        sheet7.setStyle(4, i, style, GC.Spread.Sheets.SheetArea.viewport);
    }
    sheet7.setStyle(1, 1, formulaStyle, GC.Spread.Sheets.SheetArea.viewport);
    sheet7.setStyle(2, 1, formulaStyle, GC.Spread.Sheets.SheetArea.viewport);
});

See Also

HLOOKUP|LOOKUP