R语言 rJava包 jcastToArray()函数中文帮助文档(中英文对照)

loveR

jcastToArray(rJava)
jcastToArray()所属R语言包：rJava

                                         Ensures that a given object is an array reference
                                         确保一个给定的对象是一个数组的引用

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

.jcastToArray takes a Java object reference of any kind and returns Java array reference if the given object is a reference to an array.
.jcastToArray需要任何类型的Java对象的引用，如果给定的对象是一个数组的引用，并返回Java数组参考。


用法----------Usage----------


.jcastToArray(obj, signature=NULL, class="", quiet=FALSE)



参数----------Arguments----------

参数：obj
Java object reference to cast or a scalar vector
Java对象的引用，投一个标量向量


参数：signature
array signature in JNI notation (e.g. "[I" for an array of integers). If set to NULL (the default), the signature is automatically determined from the object's class.
数组在JNI符号签名（如"[I"为一个整数数组）。如果设置为NULL（默认），签名自动确定对象的类。


参数：class
force the result to pose as a particular Java class. This has the same effect as using .jcast on the result and is provided for convenience only.
强制的结果作为一个特殊的Java类构成。这有同样的效果，并使用结果.jcast只为方便提供。


参数：quiet
if set to TRUE, no failures are reported and the original object is returned unmodified.
如果设置为TRUE，无故障报告和返回未修改的原始对象。


Details

详情----------Details----------

Sometimes a result of a method is by definition of the class java.lang.Object, but the acutal referenced object may be an array. In that case the method returns a Java object reference instead of an array reference. In order to obtain an array reference, it is necessary to cast such an object to an array reference - this is done using the above .jcastToArray function.
有时，一个方法的结果是由定义类java.lang.Object，但在acutal引用的对象可能是一个数组。在这种情况下，该方法返回Java对象的引用，而不是一个数组引用。为了获得一个数组的引用，它是必要投这样一个对象数组引用 - 这是使用上述.jcastToArray功能。

The input is an object reference that points to an array. Ususally the signature should be left at NULL such that it is determined from the object's class. This is also a check, because if the object's class is not an array, then the functions fails either with an error (when quiet=FALSE) or by returing the original object (when quiet=TRUE). If the signature is set to anything else, it is not verified and the array reference is always created, even if it may be invalid and unusable.
输入的是一个对象的引用，指向一个数组。 NULL这是确定对象的类来讲，通常应留给签名。这也是一个检查，因为如果不是一个数组对象的类，那么函数失败要么与一个错误（当quiet=FALSE）或returing原始对象（quiet=TRUE）。如果签名设置为别的，它是不核实，始终创建数组引用，即使它可能是无效的，无法使用。

For convenience .jcastToArray also accepts non-references in which case it simply calls .jarray, ignoring all other parameters.
为方便起见，.jcastToArray也接受非引用在这种情况下，它只是简单地调用的.jarray，忽略所有其它参数。


值----------Value----------

Returns a Java array reference (jarrayRef) on success. If quiet is TRUE then the result can also be the original object in the case of failure.
返回一个Java数组引用（jarrayRef）上的成功。如果quiet是TRUE那么结果也可以在失败的情况下，原来的对象。


举例----------Examples----------


## Not run: [＃无法运行：]
a <- .jarray(1:10)
print(a)
# let's create an array containing the array[让我们创建一个包含数组的数组]
aa <- .jarray(list(a))
print(aa)
ba <- .jevalArray(aa)[[1]]
# it is NOT the inverse, because .jarray works on a list of objects[这不是逆，因为对象名单。jarray]
print(ba)
# so we need to cast the object into an array[所以我们需要转换成一个数组对象]
b <- .jcastToArray(ba)
# only now a and b are the same array reference[只是现在A和B是相同的数组引用]
print(b)
# for convenience .jcastToArray behaves like .jarray for non-references[为方便。jcastToArray行为像非引用jarray]
print(.jcastToArray(1:10/2))

## End(Not run)[＃结束（不运行）]

转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。