R语言【base】——do.call()：根据名称或函数以及要传递给它的参数列表构造并执行函数调用

ALittleHigh2024-01-05 0:34

Package base version 4.2.0

Parameters

R 复制代码

do.call(what, args, quote = FALSE, envir = parent.frame())

参数【what】：命名要调用的函数的函数或非空字符串。

参数【args】：函数调用的参数列表。参数【args】的 names 属性为参数提供名称。

参数【quote】：指示是否引用参数的逻辑值。

参数【envir】：用于评估调用的环境。如果调用的内容是字符串，参数是符号或带引号的表达式，这将非常有用。

Detail

如果参数【quote】为 FALSE（默认值），那么将对参数进行评估（在调用环境中，而不是在 envir 中）。如果参数【quote】为 TRUE，则每个参数都会被加引号，这样参数评估的效果就是移除引号，在构造调用时保留未评估的原始参数。

对于使用 do.call求值的函数，某些函数（如 substitute）的行为与解释器求值的行为不同。确切的语义目前尚未定义，可能会有变化。

Value

函数调用（已评估）的结果。

Warning

这不应被用来试图规避对使用 .Internal 和其他非 API 调用的限制。

Example

R 复制代码

do.call("complex", list(imaginary = 1:3))

## if we already have a list (e.g., a data frame)
## we need c() to add further arguments
tmp <- expand.grid(letters[1:2], 1:3, c("+", "-"))
do.call("paste", c(tmp, sep = ""))

do.call(paste, list(as.name("A"), as.name("B")), quote = TRUE)

## examples of where objects will be found.
A <- 2
f <- function(x) print(x^2)
env <- new.env()
assign("A", 10, envir = env)
assign("f", f, envir = env)
f <- function(x) print(x)
f(A)                                      # 2
do.call("f", list(A))                     # 2
do.call("f", list(A), envir = env)        # 4
do.call( f,  list(A), envir = env)        # 2
do.call("f", list(quote(A)), envir = env) # 100
do.call( f,  list(quote(A)), envir = env) # 10
do.call("f", list(as.name("A")), envir = env) # 100

eval(call("f", A))                      # 2
eval(call("f", quote(A)))               # 2
eval(call("f", A), envir = env)         # 4
eval(call("f", quote(A)), envir = env)  # 100