xlcCall {XLConnect}R Documentation

Automatic argument vectorization, default Java exception and warnings handling for XLConnect

Description

Performs automatic argument vectorization, provides default Java exception and warnings handling for XLConnect.

Usage

xlcCall(obj, fun, ..., SIMPLIFY = TRUE)

Arguments

obj

XLConnect S4 object (e.g workbook, cellstyle) which has a slot jobj representing a rJava jobjRef object whose method represented by the argument fun should be called.

fun

Name of function to be called.

...

Arguments to the function to be called. These arguments will be automatically vectorized using mapply.

SIMPLIFY

Argument to mapply. Attempt to reduce result of function call to a vector or matrix?

Details

This function makes use of mapply to perform automatic argument vectorization. Non-atomic arguments are wrapped in a list using wrapList first. The list of the resulting arguments is then being vectorized using mapply before the specified function is being called. The function call is wrapped with jTryCatch to catch Java exceptions. Further, any warnings are retrieved from the Java side and are logged via R's standard warning mechanism.

Value

Result of the specified function by calling it with the vectorized argument list.

Author(s)

Martin Studer
Mirai Solutions GmbH http://www.mirai-solutions.com

See Also

wrapList, jTryCatch


[Package XLConnect version 0.2-7 Index]