如何使用带有 ArrayFormula 的自定义函数

Question

我想编写一个可以在 ArrayFormula 中使用的函数。我的桌子是这样的：

 | A | B | C |
1| a |   |   |
2| b |   |   |
3| c |   |   |

首先我写了一个简单的函数来返回输入（所以我知道它在 ArrayFormula 中工作）：

function retAddress(cell){
  return cell;
}

在 B1 上，我写了 =ArrayFormula(retAddress(address(row(B:B),column(A:A),4)))，显然它按预期工作，它返回每个地址，如下所示：

 | A | B | C |
1| a | A1|   |
2| b | A2|   |
3| c | A3|   |

现在，在 C 列，我想返回 A 列的值，所以我写了一个这样的函数：

function retValue(cell){
  var cellRang = SpreadsheetApp.getActive().getRange(cell);
  return cellRang.getValue();
}

在 C1 上我写了=ArrayFormula(retValue(address(row(B:B),column(A:A),4)))，但它给了我错误Exception: Range not found (line 2).，这是getRange(cell) 方法的行。

如果我像这样编写没有 ArrayFormula 的函数：

在 C1 上，=retValue(address(row(C1),column(A:A),4))

在 C2 上，=retValue(address(row(C2),column(A:A),4))

在 C3 上，=retValue(address(row(C3),column(A:A),4))

我得到了预期的结果：

 | A | B | C |
1| a | A1| a |
2| b | A2| b |
3| c | A3| c |

那么，如何让它在 ArrayFormula 中工作？

Answer 1

问题：

SpreadsheetApp.getActive().getRange(cell)

cell 是数组，如果您提供数组输入。 getRange 方法需要一个字符串作为输入。

解决办法：

• map 数组转单值

参考资料：

• Custom Function#Optimization
• Best practices

片段#1：

function retValue(cell){
  if(cell.map) {
    return cell.map(retValue);
  } else {
    var cellRang = SpreadsheetApp.getActive().getRange(cell);
    return cellRang.getValue();
  }
}

片段#2：

请注意，在前面的 sn-p 中，您对输入数组中的每个单元格调用 getValue() 1 次。这是非常缓慢的。更好的方法是批量调用它：

=retValues("A1:B4")

function retValues(cell){//modified
  var cellRang = SpreadsheetApp.getActive().getRange(cell);
  return cellRang.getValues();//modified
}

• 请注意：
  • 只拨打了 1 次到 getValues() 的电话。
  • 公式返回一个未显式使用=ARRAYFORMULA() 的数组。默认情况下，所有自定义公式都是数组公式，但需要将它们配置为在应用脚本中以数组形式返回值。