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

loveR

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

                                        Read a Document Type Definition (DTD)
                                         阅读文档类型定义（DTD）

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

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

Represents the contents of a DTD as a user-level object containing the element and entity definitions.
用户级别的对象，它包含的元素和实体定义的DTD的内容。


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


parseDTD(extId, asText=FALSE, name="", isURL=FALSE, error = xmlErrorCumulator())



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

参数：extId
The name of the file containing the DTD to be processed.
的名称，该文件包含的DTD以被处理。


参数：asText
logical indicating whether the value of "extId" is the name of a file or the DTD content itself. Use this when the DTD is read as a character vector, before being parsed  and handed to the parser as content only.
逻辑表示的值是否“EXTID”是一个文件的名称或DTD内容本身。使用时的DTD中读取一个字符向量，内容只被解析并传递给分析器之前。


参数：name
Optional name to provide to the parsing mechanism.
提供可选名称解析机制。


参数：isURL
A logical value indicating whether the input source is to be considred a URL or a regular file or string containing the XML.
一个逻辑值，该值指示是否是considred一个URL或一个普通的文件或字符串，其中包含的XML输入源。


参数：error
an R function that is called when an error is encountered. This can report it and continue or terminate by raising an error in R.  See the error parameter for link{xmlTreeParse}.
R的功能，遇到错误时调用。这可报告和继续或终止抛出一个错误R.错误的参数为link{xmlTreeParse}。


Details

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

Parses and converts the contents of the DTD in the specified file  into a user-level object containing all the information about the DTD.
解析和转换的DTD指定的文件到用户级别的对象，它包含的所有信息的DTD的内容。


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

A list with two entries, one for the entities and the other for the elements defined within the DTD.
列表有两个项目，一个是实体和其他在DTD定义的元素。


参数：entities
a named list of the entities defined in the DTD.  Each entry is indexed by the name of the corresponding entity. Each is an object of class XMLEntity or alternatively XMLExternalEntity if the entity refers to an external definition. The fields of these types of objects are   
在DTD定义的实体命名列表。每个条目的索引由相应的实体的名称。每类的一个对象XMLEntity或者XMLExternalEntity如果实体是指一个外部定义。这些类型的对象的字段是

namethe name of the entity by which users refer to it.  
namethe实体的名称，使用户参考。

contentthe expanded value or definition of the entity  
contentthe扩展的值或定义的实体

originalthe value of the entity, but with references to other entities not expanded, but maintained in symbolic form.  
originalthe价值的实体，但没有扩大，而是保持着以符号的形式向其他实体的引用。


参数：elements
a named list of the elements defined in the DTD, with the name of each element being the identifier of the element being defined. Each entry is an object of class XMLElementDef which has 4 fields.   
在DTD中定义的元素，每个元素的元素被定义的标识符的名称命名列表。每一项都是一个对象类XMLElementDef有4个领域。

namethe name of the element.  
namethe的元素的名称。

typea named integer indicating the type of entry in the DTD, usually either element or mixed. The name of the value is a user-level type. The value is used for programming, both internally and externally.   
A型命名为整数，表示在DTD中的条目的类型，通常是element或mixed。的名称的值是一个用户级的类型。该值用于编程，内部和外部。

contentsa description of the elements that can be nested within this element. This is an object of class XMLElementContent or one of its specializations - XMLSequenceContent, XMLOrContent. Each of these encodes the number of such elements permitted  (one, one or more, zero or one, or zero or more); the type indicating whether the contents consist of a single element type, an ordered sequence of elements, or one of a set of elements. Finally, the actual contents description is described in the elements field. This is a list of one or more XMLElementContent, XMLSequenceContent and XMLOrContent  objects.   
contentsa的元素可以嵌套在此元素的描述。这是一个对象的类XMLElementContent之一，它的专业 - XMLSequenceContent，XMLOrContent。每个这些编码不允许的（1，一个或多个，零或1，或零个或更多）的数目的这样的元素的类型指示的内容是否包括一个单一的元素类型，一个有序的元素序列，或者a的元素集合。最后，实际的内容的说明中描述的elements字段。这是一个列表中的一个或多个XMLElementContent，XMLSequenceContent和XMLOrContent对象。

attributesa named list of the attributes defined for this element in the DTD. Each element is of class XMLAttributeDef which has 4 fields.  namename of the attribute, i.e. the left hand side  typethe type of the value, e.g. an CDATA, Id, Idref(s), Entity(s), NMToken(s),  Enumeration, Notation  defaultTypethe defined type, one of  None, Implied, Fixed or Required.  defaultValuethe default value if it is specified, or the enumerated values as a character vector, if the type is Enumeration.   
attributesa命名此元素在DTD定义的属性列表。每个元素是类XMLAttributeDef有4个领域。的属性的namename，即左手侧typethe类型的值，例如CDATA，ID，IDREF（S），实体（S），NMTOKEN（S），枚举，符号defaultTypethe定义的类型，一为“无”，暗示，的固定或要求。 defaultValuethe默认值，如果它被指定，或作为一个字符向量的枚举值，如果是枚举类型。


警告----------WARNING----------

Errors in the DTD are stored as warnings for programmatic access.
警告以编程方式访问存储在DTD中的错误。


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

Needs libxml (currently version 1.8.7) from
需要的libxml（目前版本为1.8.7）


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


Duncan Temple Lang <duncan@wald.ucdavis.edu>



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

<h3>See Also</h3>  <code>xmlTreeParse</code>,

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


dtdFile <- system.file("exampleData", "foo.dtd",package="XML")
parseDTD(dtdFile)

txt <- readLines(dtdFile)
txt <- paste(txt,  collapse="\n")
d <- parseDTD(txt, asText=TRUE)


## Not run: [＃不运行：]
url <- "http://www.omegahat.org/XML/DTDs/DatasetByRecord.dtd"
d <- parseDTD(url, asText=FALSE)  

## End(Not run)[＃（不执行）]

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


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