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

loveR

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

                                        XML output streams
                                         XML输出流

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

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

These two functions provide different ways to construct XML documents incrementally.  They provide a single, common interface for adding and closing tags, and inserting nodes.  The buffer version stores the XML representation as a string.  The DOM version builds the tree of XML node objects entirely within R.
这两个函数提供了不同的方式，逐步构建XML文档。他们提供了一个单一的，通用的接口，用于添加和关闭标签，并插入节点。缓冲版本存储的XML表示形式为一个字符串。 DOM版本生成的XML节点对象的树，完全在R.


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


xmlOutputBuffer(dtd=NULL, nameSpace="", buf=NULL,
                             nsURI=NULL, header="<?xml version=\"1.0\"?>")

xmlOutputDOM(tag="doc", attrs = NULL, dtd=NULL,
                          nameSpace=NULL, nsURI=character(0),
                          xmlDeclaration = NULL)



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

参数：dtd
a DTD object (see parseDTD and xmlTreeParse) which contains specifications about what elements are valid within other elements and what attributes are supported by different elements. This can be used to validate the document as it is being constructed incrementally.
一个DTD对象（见parseDTD和xmlTreeParse），其中包含哪些要素是有效的内其他元素和属性的规格所支持的不同的元素。这可以用来验证文件，因为它正在逐渐构建起来。


参数：attrs
attributes for the top-level node, in the form of a named vector or list.
为顶层节点的属性，在一个命名的矢量或列表的形式。


参数：nameSpace
the default namespace identifier to be used when an element is created without an explicit namespace. This provides a convenient way to specify the default name space that appers in tags throughout the resulting document.
没有一个明确的命名空间中的元素被创建时使用默认的命名空间标识符。这提供了一个方便的方式来指定默认的名字空间，appers在整个文件的标签。


参数：buf
a connection object or a string into which the XML content is written. This is currently a simplistic implementation since we will use the OOP-style classes from the Omegahat projects in the future.
一个连接对象或字符串的XML内容写入。这是一个简单的实现，因为目前从Omegahat项目的未来，我们将使用OOP风格类。


参数：nsURI
the URI or value for the name space which is used when declaring the namespace. For xmlOuputDOM, this is a named character vector with each element giving the name space identifier and the corresponding URI, \ e.g c(shelp = "http://www.omegahat.org/XML/SHelp")  
URI或值时所使用的命名空间声明的名称空间。对于xmlOuputDOM，这是一个指定的字符矢量与每个元素发出的名字空间的标识符和相应的URI，\例如c(shelp = "http://www.omegahat.org/XML/SHelp")


参数：header
if non-NULL, this is immediately written to the output stream allowing one to control the initial section of the XML document.
如果非NULL，这是立即写入到输出流允许控制的初始段的XML文档。


参数：tag
the name of the top-level node/element in the DOM being created.
正在创建的DOM中的顶层节点/元素的名称。


参数：xmlDeclaration
a logical value or a string. If this is a logical value and TRUE, the default <?xml version='1.0'?> processing instruction is emitted at the top of the document.   If it is FALSE, no xml declaration is emitted at the top of the document. If this is provided as a string, the contents of this is added as the content of the processing instruction.   A version='1.0' is added if there is no  'version=' content within the given string.  
逻辑值或一个字符串。如果这是一个逻辑值和TRUE，默认的<？xml版本= 1 .0？>处理指令是在该文件的顶部射出。如果是FALSE，没有XML声明发出的文件的顶部。如果这是作为一个字符串，在此提供的处理指令的内容被添加为。被添加的版本= 1 .0，如果没有版本的内容在给定的字符串。


Details

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

These functions create a closure instance which provides methods or functions that operate on shared data used to represent the contents of the XML document being created and the current state of that creation.
这些功能创建一个闭包为代表的内容的XML文档创建和目前的状态，创造共享数据的方法或函数操作的实例。


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

Both of these functions return  a list of functions which operate on the XML data in a shared environment.
这两个函数返回一个列表，在共享环境中的XML数据操作的功能。


参数：value
get the contents of the XML document as they are currently  defined.
获取的内容的XML文档的作为他们当前定义。


参数：addTag
add a new element to the document, specifying its name and attributes. This allows the tag to be left open so that new elements will be added as children of it.
添加一个新元素添加到文档中，指定它的名称和属性。这使这种标签处于打开状态，将加入新的元素作为它的子。


参数：closeTag
close the currently open tag, indicating that new elements will be added, by default,  as siblings of this one.
关闭当前打开的标签，添加新的元素，默认情况下，作为这其中的兄弟姐妹，。


参数：reset
discard the current contents of the document so that we can start over and free the resources (memory) associated with this document.
丢弃当前文件的内容，使我们可以重新开始，并释放与此文档相关的资源（内存）。

The following are specific to xmlOutputDOM:
以下是特定xmlOutputDOM：


参数：addNode
insert an complete XMLNode object into the currently active (i.e. open)  node.
一个完整的XMLNode对象插入到当前活动节点（即打开）。


参数：current
obtain the path or collection of indices to  to the currently active/open node from the root node.
获得路径或收集的指标，从根节点到当前活动/打开节点。


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


Duncan Temple Lang



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



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

xmlTree for a native/internal (C-level) representation of the tree, xmlNode, xmlTextNode, append.xmlNode
xmlTree的本地/内部（C级）表示的树，xmlNode，xmlTextNode，append.xmlNode的

And a different representation of a tree is available via xmlHashTree.
树的不同表示形式是可以通过xmlHashTree的。


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


con <- xmlOutputDOM()
con$addTag("author", "Duncan Temple Lang")
con$addTag("address",  close=FALSE)
con$addTag("office", "2C-259")
con$addTag("street", "Mountain Avenue.")
con$addTag("phone", close = FALSE)
   con$addTag("area", "908", attrs=c(state="NJ"))
   con$addTag("number", "582-3217")
con$closeTag() # phone[检测]
con$closeTag() # address[地址]

con$addTag("section", close = FALSE)
con$addNode(xmlTextNode("This is some text "))
con$addTag("a","and a link", attrs=c(href="http://www.omegahat.org"))
con$addNode(xmlTextNode("and some follow up text"))

con$addTag("subsection", close = FALSE)
   con$addNode(xmlTextNode("some addtional text "))
   con$addTag("a", attrs=c(href="http://www.omegahat.org"), close=FALSE)
     con$addNode(xmlTextNode("the content of the link"))
   con$closeTag() # a[一]
con$closeTag() # "subsection"[“款”]
con$closeTag() # section[部分]


d <- xmlOutputDOM()
d$addPI("S", "plot(1:10)")
d$addCData('x <- list(1, a="&amp;");\nx[[2]]')
d$addComment("A comment")
print(d$value())
print(d$value(), indent = FALSE, tagSeparator = "")


d = xmlOutputDOM("bob", xmlDeclaration = TRUE)
print(d$value())

d = xmlOutputDOM("bob", xmlDeclaration = "encoding='UTF-8'")
print(d$value())


d = xmlOutputBuffer("bob", header = "<?xml version='1.0' encoding='UTF-8'?>",
                      dtd = "foo.dtd")
d$addTag("bob")
cat(d$value())

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


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