调用 Arrow 计算函数

此函数提供了一个低级 API，用于通过其字符串函数名称调用 Arrow 函数。在大多数应用程序中，您不会直接使用它。许多 Arrow 计算函数映射到 R 方法，在 dplyr 评估上下文中，所有 Arrow 函数 都可以使用 arrow_ 前缀调用。

用法

call_function(
  function_name,
  ...,
  args = list(...),
  options = empty_named_list()
)

参数

function_name

字符串 Arrow 计算函数名称

...

函数参数，可能包括 Array、ChunkedArray、Scalar、RecordBatch 或 Table。

args

作为在 ... 中指定参数的替代方法，以列表形式提供参数。

options

C++ 函数选项的命名列表。

返回值

Array、ChunkedArray、Scalar、RecordBatch 或 Table，取决于计算函数的结果。

详细信息

在 ...、args 或 options 中传递索引时，以 0 为基数的整数表示（与 C++ 一致）。

参见

Arrow C++ 文档 中介绍了函数及其各自的选项。

示例

a <- Array$create(c(1L, 2L, 3L, NA, 5L))
s <- Scalar$create(4L)
call_function("coalesce", a, s)
#> Array
#> <int32>
#> [
#>   1,
#>   2,
#>   3,
#>   4,
#>   5
#> ]

a <- Array$create(rnorm(10000))
call_function("quantile", a, options = list(q = seq(0, 1, 0.25)))
#> Array
#> <double>
#> [
#>   -3.3041822296584606,
#>   -0.675501909840726,
#>   0.0011218985985251336,
#>   0.674597899120164,
#>   3.5889486327287328
#> ]