xlcCall
Automatic argument vectorization, default Java exception and warnings handling for XLConnect
Performs automatic argument vectorization, provides default Java exception and warnings handling for XLConnect.
- Keywords
- internal
Usage
xlcCall(obj, fun, ..., .recycle = TRUE, .simplify = TRUE)
Arguments
- obj
XLConnect S4 object (e.g
'>workbook
,'>cellstyle
) which has a slotjobj
representing a rJavajobjRef
object whose method represented by the argumentfun
should be called.- fun
Name of Java method to be called.
- …
Arguments to the Java method to be called.
- .recycle
If
TRUE
(default), arguments passed through … will be automatically vectorized usingmapply
andfun
will be called the appropriate amount of times. IfFALSE
, no vectorization will take place in R andfun
will be called once only. This may be used to implement vectorization on the Java side.- .simplify
Only relevant if
.recycle = TRUE
. Argument to internalmapply
to set if there should be an attempt to reduce the result 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.