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

loveR

xmlParent(XML)
xmlParent()所属R语言包：XML

                                        Get parent node of XMLInternalNode or ancestor nodes
                                         的XMLInternalNode或祖先节点的父节点

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

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

xmlParent operates on an XML node and returns a reference to its parent node  within the document tree. This works for an internal, C-level XMLInternalNode object created, for examply, using newXMLNode and related functions or xmlTree or  from xmlTreeParse with the useInternalNodes parameter.
xmlParent一个XML节点上运行，并返回一个引用到它的父节点在文档树。此工程的内部，C级XMLInternalNode创建的对象，对于为例，使用newXMLNode和相关的功能或xmlTree或xmlTreeParseuseInternalNodes参数。

It is possible to find the parent of an R-level XML node when using a tree created with, for example,  xmlHashTree as the parent information is stored separately.
这是可能的R-级XML节点找到父时创建的，例如，使用一个树xmlHashTree作为父信息分别存储。

xmlAncestors walks the chain of parens to the top of the document and either returns a list of those nodes, or alternatively a list of the values obtained by applying a function to each of the nodes.
xmlAncestors走链的括号文档的顶部，或者返回一个列表中的那些节点，或者一个应用一个函数，每个节点通过以下方式获得的值的列表。


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


xmlParent(x, ...)
xmlAncestors(x, fun = NULL, ..., addFinalizer = NA, count = -1L)



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

参数：x
an object of class XMLInternalNode whose parent is being requested.  
被请求的对象类XMLInternalNode，其父母。


参数：fun
an R function which is invoked for each  node as we walk up the tree.
一个R函数被调用的每个节点，我们走的树。


参数：...
any additional arguments that are passed in calls to fun after the node object and for xmlParent this allows methods to define their own additional parameters.
在调用任何额外的参数传递到fun后的节点对象和xmlParent这个方法来定义自己的额外参数。


参数：addFinalizer
a logical value indicating whether the default finalizer routine should be registered to free the internal xmlDoc when R no longer has a reference to this external pointer object. This can also be the name of a C routine or a reference to a C routine retrieved using getNativeSymbolInfo.  
一个逻辑值，该值指示是否默认终结程序的，应当予以登记，释放内部的xmlDoc当R不再有外部指针对象的引用，这。这也可以检索使用getNativeSymbolInfoC程序或C程序的名称。


参数：count
an integer that indicates how many levels of the hierarchy to traverse. This allows us to get the count most recent ancestors of the node.
一个整数，表示有许多层次结构中的穿越。这使我们能够得到count最近祖先的节点。


Details

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

This uses the internal libxml structures to access the parent in the DOM tree.  This function is generic so that we can add methods for other types of nodes if we so want in the future.
这种使用的libxml内部结构的访问DOM树中的父。此功能是通用的，因此，我们可以添加其他类型的节点，如果我们希望在未来的方法。


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

xmlParent returns object of class XMLInternalNode.
xmlParent返回对象的类XMLInternalNode。

If fun is NULL, xmlAncestors returns a list of the nodes in order of top-most node or root of the tree, then its child, then the child of that child, etc. This is the reverse order in which the nodes are visited/found.
如果funNULL，xmlAncestors返回一个节点列表，以最上面的节点树的根，那么它的孩子，那么这个孩子的孩子，等等。这是相反的顺序进行，其中节点被访问/发现。

If fun is a function, xmlAncestors returns a list whose elements are the results of calling that function for each node. Again, the order is top down.
如果fun是一个函数，xmlAncestors返回一个列表，其元素是调用该函数的每个节点的结果。同样，顺序是自上而下的。


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


Duncan Temple Lang



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

<h3>See Also</h3>   <code>xmlChildren</code> <code>xmlTreeParse</code> <code>xmlNode</code>

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



  top = newXMLNode("doc")
  s = newXMLNode("section", attr = c(title = "Introduction"))
  a = newXMLNode("article", s)
  addChildren(top, a)

  xmlName(xmlParent(s))
  xmlName(xmlParent(xmlParent(s)))


    # Find the root node.[查找根节点。]
  root = a
  while(!is.null(xmlParent(root)))
      root = xmlParent(root)

   # find the names of the parent nodes of each 'h' node.[找到的每个h的节点的父节点的名称。]
   # use a global variable to "simplify" things and not use a closure.[使用一个全局变量来“简化”的事情，而不是使用闭包。]

  filename = system.file("exampleData", "branch.xml", package = "XML")
  parentNames <- character()
  xmlParse(filename,
                handlers =
                  list(h = function(x) {
                   parentNames <<- c(parentNames, xmlName(xmlParent(x)))
                  }))

  table(parentNames)

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


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