何时使用@xw.arg 和@xw.ret 在 xlwings 中编写 UDF？

Question

一些 xlwings UDF 使用@xw.arg 和@xw.ret。有些人没有。开发者在xlwings中写UDF时应该在什么情况下使用@xw.arg和@xw.ret？这是开发人员应该始终遵循的最佳实践吗？像 python 打字？

我正在使用 xlwings 0.19.4，python 3.7，Excel 2016。

Answer 1

来自docs：

这些装饰器对于 UDF 就像选项方法对于 Range 对象一样：它们允许您将转换器及其选项应用于函数参数 (@xw.arg) 和 return 值 (@ xw.ret)。例如，要将参数 x 转换为 pandas DataFrame 并在 returning 时抑制索引，您可以执行以下操作：

@xw.func
@xw.arg('x', pd.DataFrame)
@xw.ret(index=False)
def myfunction(x):
   # x is a DataFrame, do something with it
   return x

When to use @xw.arg and @xw.ret for writing UDFs in xlwings?