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

loveR

subListExtract(Biobase)
subListExtract()所属R语言包：Biobase

                                        Extract the same element from the sublists of a list
                                         从列表的子列表中提取相同的元素

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

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

Given a list of lists, this function can be used to extract a named element from each sublist.
鉴于一个列表，这个功能可以用来提取每个子表的命名元素。


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


subListExtract(L, name, simplify = FALSE, keep.names = TRUE)



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

参数：L
A list of named lists
命名名单列表


参数：name
The name of the element in the sublists that should be extracted.  This should be a length one character vector.
应当提取的子列表中的元素的名称。这应该是一个长度为一个字符向量。


参数：simplify
When TRUE, the return value will be an atomic vector.  If any extracted sublist value has length not equal to one and simplify=TRUE, an error will be raised.  When FALSE, a list is returned containing the extracted elements.
当TRUE，返回值将是一个原子的向量。如果有任何提取的子表值不等于一simplify=TRUE，错误将引发的长度。当FALSE，将返回一个列表，包含提取的元素。


参数：keep.names
If TRUE (default), the names of L will be attached to the returned vector.
如果TRUE（默认），L的名字将被附加到返回的向量。


Details

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

This function is implemented in C and is intended to be faster than calling lapply or sapply.
此功能在C和实施的目的是比调用lapply或sapply快。


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

If simplify=FALSE, a list will be returned having the same length as L, but with each element containing the element named name from the corresponding inner list of L.
如果simplify=FALSE的，一个列表将返回具有相同长度的L，但每个元素包含名为name的L从相应的内部列表的元素。

When simplify=TRUE, an atomic vector will be returned containing the extracted elements.  If any of the inner list elements do not have length one or cannot be put inside an atomic vector, an error will be raised.
当simplify=TRUE，一个原子的向量将返回包含提取的元素。如果有任何内部列表元素没有一个长度或不能把内部的原子向量，将引发错误。


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


Seth Falcon



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


list_size = 500000
innerL = list(foo="foo", bar="bar")
L = rep(list(innerL), list_size)

system.time({j0 = sapply(L, function(x) x$foo)})
system.time({j1 = subListExtract(L, "foo", simplify=TRUE)})
stopifnot(all.equal(j0, j1))

LS = L[1:3]
names(LS) = LETTERS[1:3]
subListExtract(LS, "bar", simplify=TRUE)
subListExtract(LS, "bar", simplify=FALSE)
subListExtract(LS, "bar", simplify=TRUE, keep.names=FALSE)

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


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