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

loveR

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

                                        Terminate an XML parser
                                         终止一个XML解析器

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

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

This function allows an R-level function to terminate an XML parser before it completes the processing of the XML content. This might be useful, for example, in event-driven parsing with xmlEventParse  when we want  to read through an XML file until we find a record of interest. Then, having retrieved the necessary information, we want to  terminate the parsing rather than let it pointlessly continue. Instead of raising an error in our handler function, we can call xmlStopParser and return. The parser will then take control again and terminate and return back to the original R function from which it was invoked.
R-级功能，该功能允许终止之前完成处理的XML内容的XML解析器。这可能是有用的，例如，在事件驱动的解析xmlEventParse，当我们想通过一个XML文件中读取，直到找到感兴趣的记录。然后，检索到所需的信息，我们要终止的分析，而不是让它白白继续。而不是提高我们的处理函数中的错误，我们可以调用xmlStopParser和回报。然后解析器将再次控制和终止，并返回到原来的R从它被调用的函数。

The only argument to this function is a reference to internal C-level  which identifies the parser.   This is passed by the R-XML parser mechanism to a function invoked by the parser if that function inherits (in the S3 sense) from the class XMLParserContextFunction.
仅此函数的参数是一个参考的内部标识的解析器的C级。这是通过由分析器调用的函数，如果该函数继承（在S3意义）从类XMLParserContextFunction的R-XML解析器机制。


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


xmlStopParser(parser)



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

参数：parser
an object of class XMLParserContext which must have been obtained by via an XMLParserContextFunction function called by the parser. This is just a handler function whose class includes XMLParserContextFunction  
类XMLParserContext必须已获得通过XMLParserContextFunction函数调用的解析器对象。这仅仅是一个处理函数的类包含了XMLParserContextFunction


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

TRUE if it succeeded and an error is raised  if the parser object  is not valid.
TRUE如果成功，则将引发一个错误，如果parser对象是无效的。


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


Duncan Temple Lang



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

<h3>See Also</h3>    <code>xmlEventParse</code>

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



  ############################################[＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃＃]
  # Stopping the parser mid-way and an example of using XMLParserContextFunction.[停止解析器中途使用XMLParserContextFunction的例子。]

  startElement =
  function(ctxt, name, attrs, ...)  {
    print(ctxt)
      print(name)
      if(name == "rewriteURI") {
           cat("Terminating parser\n")
           xmlStopParser(ctxt)
      }
  }
  class(startElement) = "XMLParserContextFunction"  
  endElement =
  function(name, ...)
    cat("ending", name, "\n")

  fileName = system.file("exampleData", "catalog.xml", package = "XML")
  xmlEventParse(fileName, handlers = list(startElement = startElement, endElement = endElement))

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


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