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

loveR

checkReturnValue(TypeInfo)
checkReturnValue()所属R语言包：TypeInfo

                                        Verify the return value from the function has the appropriate type
                                         验证函数的返回值有合适的类型

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

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

This function is the counterpart to checkArgs in the type validation for an R function. When called, either implicitly or explicitly when the function returns, it attempts to determine whether the value being returned by the function call is valid relative to the type information of the function and the call itself. Specifically, it uses the signature of the current call to the function if it is available (returned by checkArgs) to see if it has a specified return type. If so, it compares the return value to that. Otherwise, it checks to see if the return type for the overall type info object (not just the specific type signature for the call) is specified and then uses that to validate the type. If neither is specified, then the value is not validated and the value returned.
此功能是对口checkArgsR函数的类型验证。调用时，或明或暗地在函数返回时，它试图确定被调用该函数的返回值是否是有效的，相对的类型信息的功能和调用本身。具体来说，它采用了当前呼叫的签名的功能，如果它是可用（checkArgs返回），看它是否有一个指定返回类型。如果是这样，比较该返回值。否则，它会检查如果指定返回类型为整体型信息对象（不只是呼叫的特定类型的签名），然后使用它来验证类型。如果没有指定，则该值不验证，并返回值。


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


checkReturnValue(returnType, returnJump, sig, f = sys.function(-1))



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

参数：returnType
the specifiedtype of the return value.
返回值specifiedtype。


参数：returnJump
this is a very special value which is a call to return the value of value. It must be explicitly given in the call to checkReturnValue and is used to ensure that the return from checkReturnValue returns from the calling function also in the case that the value is valid. This is a piece of magic in R that is very powerful using the lazy evaluation of the arguments that allows us to return from the place that the return call was specified.  
这是一个非常特殊的价值，这是呼叫返回value的价值。它必须明确调用checkReturnValue在给定的用于确保从checkReturnValue返回调用函数的情况下，还值是有效的回报。这是一个神奇的一块R中使用的论据懒惰的评价，使我们能够返回return呼叫指定的地方，这是非常强大的。


参数：sig
the signature corresponding to the call of the function f. This should have a returnType slot that contains class information or an expression. Otherwise, the value is taken from the TypeSpecification-class object for the entire function and its returnType slot.  
签名相应的调用函数f。这应该有一个returnType槽包含类信息或表达。否则，该值从TypeSpecification-class对象为整个功能和其returnType插槽。


参数：f
the function object whose return value is to be validated. It is from this that we get the type info via typeInfo.
其返回值的函数对象是被验证。这是我们得到的类型信息通过typeInfo来源于此。


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

If the validation takes place and is successful or simply doesn't take place because no returnType is available, the return value is value. Otherwise, if the validation fails, an error is raised.
如果验证需要的地方，是成功或根本不会发生，因为没有returnType可用，返回值是value。否则，如果验证失败，将引发错误。


注意----------Note----------

This is a prototype to illustrate the idea. It might be done in C code in the future within the R interpreter.
这是一个原型来说明的想法。它可能在未来的代码在C内的R解释。


作者（S）----------Author(s)----------


Duncan Temple Lang <duncan@wald.ucdavis.edu>



参见----------See Also----------

checkArgs TypeSpecification-class  
checkArgsTypeSpecification-class

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


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