R语言:converters()函数中文帮助文档(中英文对照)

loveR

converters(base)
converters()所属R语言包：base

                                        Management of .C argument conversion list
                                         C参数转换列表管理

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

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

These functions provide facilities to manage the extensible list of converters used to translate R objects to C pointers for use in .C calls. The number and a description of each element in the list  can be retrieved. One can also query and set the activity status of individual elements, temporarily ignoring them. And one can remove individual elements.
这些功能提供设施管理使用的转换器的可扩展列表转换为R对象在.C电话使用C指针。可检索的数量和列表中的每个元素的描述。还可以查询和设置单个元素的活动状态，暂时忽略它们。和一个可以删除单个元素。


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


getNumCConverters()
getCConverterDescriptions()
getCConverterStatus()
setCConverterStatus(id, status)
removeCConverter(id)



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

参数：id
either a number or a string identifying the element of interest in the converter list.  A string is matched against the description strings for each element to identify the element. Integers are specified starting at 1 (rather than 0).
无论是数字或字符串在转换列表中的利益确定元素。每个元素的字符串匹配对描述字符串，以确定该元素。整数被指定为1（而不是0）开始。


参数：status
a logical value specifying whether the element is to be considered active (TRUE) or not (FALSE).
一个逻辑值，指明是否被认为是积极的元素是（TRUE）或没有（FALSE）。


Details

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

The internal list of converters is potentially used when converting individual arguments in a .C call.  If an argument has a non-trivial class attribute, we iterate over the list of converters looking for the first that matches.  If we find a matching converter, we have it create the C-level pointer corresponding to the R object.  When the call to the C routine is complete, we use the same converter for that argument to reverse the conversion and create an R object from the current value in the C pointer.  This is done separately for all the arguments.
在个别参数.C呼叫转换时，转换器内部的名单可能使用。如果参数有一个不平凡的阶级属性，我们遍历寻找转换为第一，比赛名单。如果我们找到一个匹配的转换器，我们有创造的C级相应的R对象的指针。当调用C程序是完整的，我们使用相同的转换器，这样的说法，扭转转换和创建在C指针的电流值从R对象。这是单独的所有参数。

The functions documented here provide R user-level capabilities for investigating and managing the list of converters. There is currently no mechanism for adding an element to the converter list within the R language.  This must be done in C code using the routine R_addToCConverter().
这里记录的功能，提供调查和管理转换器列表R用户级功能。目前还没有在R语言元素添加到转换列表中的机制。这必须做例行R_addToCConverter()在C代码。


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

getNumCConverters returns an integer giving the number of elements in the list, both active and inactive.
getNumCConverters返回一个整数，列表中的元素，active和inactive。

getCConverterDescriptions returns a character vector containing the description string of each element of the converter list.
getCConverterDescriptions返回一个字符向量的转换列表中的每个元素的描述字符串。

getCConverterStatus returns a logical vector with a value for each element in the converter list.  Each value indicates whether that converter is active (TRUE) or inactive (FALSE). The names of the elements are the description strings returned by getCConverterDescriptions.
getCConverterStatus返回一个逻辑向量在转换列表中的每个元素的值。每个值指示是否该转换器是积极的（TRUE）或无效（FALSE）。元素的名称是由getCConverterDescriptions返回的字符串描述。

setCConverterStatus returns the logical value indicating the activity status of the specified element before the call to change it took effect.  This is TRUE for active and FALSE for inactive.
setCConverterStatus返回逻辑值，指明呼吁改变生效前的指定元素的活动状态。这是TRUE积极FALSE为无效。

removeCConverter returns TRUE if an element in the converter list was identified and removed. In the case that no such element was found, an error occurs.
removeCConverter回报TRUE如果在转换列表中的元素被识别和清除。在没有这样的元素被发现的情况下，发生错误。


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


Duncan Temple Lang



参考文献----------References----------



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

.C
.C


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


getNumCConverters()
getCConverterDescriptions()
getCConverterStatus()
## Not run: [＃无法运行：]
old <- setCConverterStatus(1, FALSE)

setCConverterStatus(1, old)

## End(Not run)[＃结束（不运行）]
## Not run: [＃无法运行：]
removeCConverter(1)
removeCConverter(getCConverterDescriptions()[1])


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


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