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

loveR

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

                                        Ensure that the node has a definition for particular XML namespaces
                                         确保该节点已定义为特定的XML命名空间

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

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

This function is a helper function for use in creating XML content. We often want to create a node that will be part of a larger XML tree and use a particular namespace for that node name. Rather than defining the namespace in each  new node, we want to ensure that it is define on an ancestor node.  This function aids in that task. We call the function with  the ancestor node or top-level document and have it check whether the namespace is already defined or have it add it to the node and return.
此功能是一个辅助函数，用于创建XML内容。我们经常要创建一个节点，这将是一个较大的XML树的一部分，并使用特定的命名空间，节点名称。而不是定义的命名空间中的每一个新的节点，我们要确保它的祖先节点上定义的。此功能有助于完成这项任务。我们的祖先节点或顶层文件，并检查是否已经定义的命名空间或已添加的节点，并返回调用该函数。

This is intended for use with XMLInternalNode objects which are direclty mutable (rather than changing a copy of the node and having to insert that back into the larger tree.)
这样做的目的使用XMLInternalNode对象是direclty可变的（而不是改变副本的节点插入到更大的树回来。）


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


ensureNamespace(doc, what)



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

参数：doc
an XMLInternalDocument or XMLInternalNode on which the namespace is to be defined.  If this is a documentm, we use the root node.
XMLInternalDocument或XMLInternalNode要定义的命名空间。如果这是一个documentm中，我们使用的是根节点。


参数：what
a named character vector giving the URIs for the namespace definitions and the names giving the desired prefixes
给一个指定的字符向量的URI命名空间定义，并得到所需要的前缀名


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

This is used for the potential side effects of modifying the XML node to add (some of) the namespaces as needed.
这是用于修改的XML节点添加的（一些）的命名空间，根据需要的潜在的副作用。


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


Duncan Temple Lang



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

<h3>See Also</h3>   <code>newXMLNamespace</code> <code>newXMLNode</code>

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


  doc = newXMLDoc()
  top = newXMLNode("article", doc = doc)
  ensureNamespace(top, c(r = "http://www.r-project.org"))
  b = newXMLNode("r:code", parent = top)
  print(doc)

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


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