调用 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.6772029597996343,
#>   0.0014695935200537034,
#>   0.6759598650974947,
#>   3.5889486327287328
#> ]