找回密码
 注册
查看: 915|回复: 0

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

[复制链接]
发表于 2012-10-2 00:00:18 | 显示全部楼层 |阅读模式
xmlElementsByTagName(XML)
xmlElementsByTagName()所属R语言包:XML

                                        Retrieve the children of an XML node with a specific tag name
                                         检索一个特定的标记名称的XML节点的孩子

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

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

This returns a list of the children or sub-elements of an XML node whose tag name matches the one specified by the user.
这将返回一个列表的孩子或子元素的XML节点的标签名称相匹配的用户指定的。


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


xmlElementsByTagName(el, name, recursive = FALSE)



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

参数:el
the node whose matching children are to be retrieved.
匹配的孩子要检索的节点的。


参数:name
a string giving the name of the tag to match in each of  el's children.
一个字符串,给出的标记的名称相匹配,每个el的孩子。


参数:recursive
a logical value. If this is FALSE, the default, only the direct child nodes are searched. Alternatively, if this is TRUE,  all sub-nodes at all levels  are searched. In other words, we find all descendants of the node el and return a list with the nodes having the given name. The relationship between the nodes in the resulting list cannot be determined. This is a set of nodes. See the note.   
一个逻辑值。如果这是FALSE,在默认情况下,只有直接子节点进行搜索。另外,如果这是TRUE,各级的所有子节点进行搜索。换句话说,我们找到的所有后代节点el“,并返回一个具有给定名称的节点列表。不能确定在结果列表中的节点之间的关系。这是一组节点。请参阅说明。


Details

详细信息----------Details----------

This does a simple matching of names and subsets the XML node's children list. If recursive is TRUE, then the function is applied recursively to the children of the given node and so on.
做一个简单的匹配XML节点的子节点列表的名称和子集。如果recursiveTRUE,那么该函数是递归的应用给定节点的孩子等。


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

A list containing those child nodes of el whose tag name matches that specified by the user.
一个列表,其中包含这些子节点的el的标签,由用户指定的名称匹配。


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

The addition of the recursive argument makes this function behave like the getElementsByTagName in other language APIs such as Java, C\#. However, one should be careful to understand that in those languages, one would get back a set of node objects. These nodes have references to their parents and children. Therefore one can navigate the tree from each node, find its relations, etc. In the current version of this package (and for the forseeable future),  the node set is a “copy” of the nodes in the original tree. And these have no facilities for finding their siblings or parent. Additionally, one can consume a large amount of memory by taking a copy of numerous large nodes using this facility. If one does not modify the nodes, the extra memory may be small. But modifying them means that the contents will be copied.
此外recursive参数,像getElementsByTagName的其他语言的API,如Java,C \#此函数的行为。然而,人们应该认真了解,在这些语言中,人们可以得到一组节点对象。这些节点有他们的父母和孩子。因此,我们可以浏览目录树的每个节点,找到自己的关系,在当前版本的软件包(以及在可预见的未来),节点集是对原来的树节点的“复制”。这些都没有找到自己的父母,兄弟姐妹或父母的设施。此外,可以消耗大量的内存,以众多的大节点,使用此工具的副本。如果不修改节点,额外的内存可能很小。但修改的内容将被复制。

Alternative implementations of the tree, e.g. using unique identifiers for nodes or via internal data structures from libxml can allow us to implement this function with different semantics, more similar to the other APIs.
替代实现的树,例如使用的唯一标识符节点,或通过内部数据结构的libxml可以具有不同的语义,更类似于其他的API,让我们来实现这个功能。


(作者)----------Author(s)----------


Duncan Temple Lang



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



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

xmlChildren xmlTreeParse
xmlChildrenxmlTreeParse


实例----------Examples----------


## Not run: [#不运行:]
doc <- xmlTreeParse("http://www.omegahat.org/Scripts/Data/mtcars.xml")
xmlElementsByTagName(doc$children[[1]], "variable")

## End(Not run)[#(不执行)]

doc <- xmlTreeParse(system.file("exampleData", "mtcars.xml", package="XML"))
xmlElementsByTagName(xmlRoot(doc)[[1]], "variable")

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


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

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

手机版|小黑屋|生物统计家园 网站价格

GMT+8, 2024-11-24 15:42 , Processed in 0.020110 second(s), 16 queries .

Powered by Discuz! X3.5

© 2001-2024 Discuz! Team.

快速回复 返回顶部 返回列表