Java array handling functions
.jarray takes a vector (or a list of Java references) as its
argument, creates a Java array containing the elements of the vector
(or list) and returns a reference to such newly created array.
.jevalArray takes a reference to a Java array and returns its
contents (if possible).
.jarray(x, contents.class = NULL, dispatch = FALSE) .jevalArray(obj, rawJNIRefSignature = NULL, silent = FALSE, simplify = FALSE)
- vector or a list of Java references
- common class of the contained objects, see details
- Java object reference to an array that is to be evaluated
- JNI signature that whould be used for
conversion. If set to
NULL, the signature is detected automatically.
- if set to true, warnings are suppressed
- logical. If
TRUEthe code attemps to dispatch to either a
jarrayRefobject for rugged arrays and
jrectRefobjects for rectangular arrays, creating possibly a multi-dimensional object in Java (e.g., when used wi
- if set to
TRUEmore than two-dimensional arrays are converted to native obejcts (e.g., matrices) if their type and size matches (essentially the inverse for objects created with
.jarray: The input can be either a vector of some sort (such as
numeric, integer, logical, ...) or a list of Java references. The
contents is pushed to the Java side and a corresponding array is
created. The type of the array depends on the input vector type. For
example numeric vector creates
double array, integer vector
int array, character vector
String array and
so on. If
x is a list, it must contain Java references only (or
NULLs which will be treated as
contents.class parameter is used only if
x is a list
of Java object references and it can specify the class that will be
used for all objects in the array. If set to
NULL no assumption
is made and
java/lang/Object will be used. Use with care and
only if you know what you're doing - you can always use
.jcast to cast the entire array to another type even if
you use a more general object type. One typical use is to construct
multi-dimensional arrays which mandates passing the array type as
The result is a reference to the newly created array.
The inverse function which fetches the elements of an array reference
.jevalArray currently supports only a subset of all possible
array types. Recursive arrays are handled by returning a list of
references which can then be evaluated separately. The only exception
simplify=TRUE in which case
.jevalArray arrempts to
convert multi-dimensional arrays into native R type if there is a
such. This only works for rectangular arrays of the same basic type
(i.e. the length and type of each referenced array is the same -
sometimes matrices are represented that way in Java).
.jarrayreturns a Java array reference (
jrectRef) to an array created with the supplied contents.
.jevalArrayreturns the contents of the array object.
.jinit() a <- .jarray(1:10) print(a) .jevalArray(a) b <- .jarray(c("hello","world")) print(b) c <- .jarray(list(a,b)) print(c) # simple .jevalArray will return a list of references print(l <- .jevalArray(c)) # to convert it back, use lapply lapply(l, .jevalArray) # two-dimensional array resulting in int d <- .jarray(list(a,a),"[I") print(d) # use dispatch to convert a matrix to [[D e <- .jarray(matrix(1:12/2, 3), dispatch=TRUE) print(e) # simplify it back to a matrix .jevalArray(e, simplify=TRUE)