The result of a server language expression is returned as a string, using the JSON standard notation to represent a scalar, list or dictionary. Methods for this function get the simple R object obtained from deparsing and interpret it generally.
1 2 3 4 5 6 7 8 9 10 11 12 13
An object constructed from the explicit representation as a dictionary. The elements of the dictionary will be converted into objects for the slots of the same name. Application-written methods will re-interpret the object into the intended R form, not necessarily from the same class.
This argument will be supplied as the evaluator object doing the conversion.
Therefore, methods may have one of the specific evaluator classes (e.g.,
The methods supplied with the 'XR' pacakage handle the standard mechanisms for interpretation. Additional methods are likely to interpret proxy class objects for which the standard XR representation in terms of class and slots is not what's actually wanted.
ProxyObject: When a proxy object appears, usually as an element of a list, it
is expanded, by using the 'Get()' method of the evaluator and calling 'asRObject()' on the
vector_R: To distinguish typed R vectors from a general JSON list, encode the
desired data as an object from the "vector_R" class.
Vector types whose elements cannot be represented in JSON (e..g, "complex") should
be returned as a list of character strings in a format that R will parse as
elements of the suitable vector object. (e.g, ".5+3i")
list: Both lists and dictionaries will come here from the basic conversion.
'names(object)' will either be NULL or all non-empty, from a dictionary.
data.frame: Assume this has been done via .RClass; avoid inheriting the list method
Application packages will typically write methods for special classes, and often for classes
themselves defined in the package. One good reason is that the server language does not
naturally return the eventually intended object in a convenient form; for example, because
it does not have typed arrays. Then a special class will be defined in R. The server code
will generate a dictionary with the
".RClass" element having the class name, plus
whatever slots make sense. The application method for
asRObject() will take these
slots and construct whatever object is really intended. For an example, see the method
Chambers, John M. (2016) Extending R, Chapman & Hall/CRC. ( Chapter 12, discussing this package, is included in the package: ../doc/Chapter_XR.pdf.)