do.call: Execute a function call

Description Usage Arguments Value See Also Examples

Description

do.call constructs and executes a function call from a name or a function and a list of arguments to be passed to it.

NOTE: This man page is for the do.call S4 generic function defined in the BiocGenerics package. See ?base::do.call for the default method (defined in the base package). Bioconductor packages can define specific methods for objects not supported by the default method.

Usage

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

Arguments

what

The default method expects either a function or a non-empty character string naming the function to be called. See ?base::do.call for the details.

Specific methods can support other objects. Please refer to the documentation of a particular method for the details.

args

The default method expects a list of arguments to the function call (the names attribute of args gives the argument names). See ?base::do.call for the details.

Specific methods can support other objects. Please refer to the documentation of a particular method for the details.

quote, envir

See ?base::do.call for a description of these arguments.

Value

The result of the (evaluated) function call.

Specific methods defined in Bioconductor packages should behave as consistently as possible with the default method.

See Also

Examples

1
2
3
do.call  # note the dispatch on the 'what' and 'args' args only
showMethods("do.call")
selectMethod("do.call", c("ANY", "ANY"))  # the default method

Example output

Loading required package: parallel

Attaching package:BiocGenericsThe following objects are masked frompackage:parallel:

    clusterApply, clusterApplyLB, clusterCall, clusterEvalQ,
    clusterExport, clusterMap, parApply, parCapply, parLapply,
    parLapplyLB, parRapply, parSapply, parSapplyLB

The following objects are masked frompackage:stats:

    IQR, mad, sd, var, xtabs

The following objects are masked frompackage:base:

    anyDuplicated, append, as.data.frame, basename, cbind, colnames,
    dirname, do.call, duplicated, eval, evalq, Filter, Find, get, grep,
    grepl, intersect, is.unsorted, lapply, Map, mapply, match, mget,
    order, paste, pmax, pmax.int, pmin, pmin.int, Position, rank,
    rbind, Reduce, rownames, sapply, setdiff, sort, table, tapply,
    union, unique, unsplit, which.max, which.min

standardGeneric for "do.call" defined from package "BiocGenerics"

function (what, args, quote = FALSE, envir = parent.frame()) 
standardGeneric("do.call")
<bytecode: 0x55827d36e730>
<environment: 0x55827d376e30>
Methods may be defined for arguments: what, args
Use  showMethods("do.call")  for currently available ones.
Function: do.call (package BiocGenerics)
what="ANY"

Method Definition (Class "derivedDefaultMethod"):

function (what, args, quote = FALSE, envir = parent.frame()) 
{
    if (!is.list(args)) 
        stop("second argument must be a list")
    if (quote) 
        args <- lapply(args, enquote)
    .Internal(do.call(what, args, envir))
}
<bytecode: 0x55827d36bbc0>
<environment: namespace:base>

Signatures:
        what 
target  "ANY"
defined "ANY"

BiocGenerics documentation built on April 17, 2021, 6:01 p.m.