EVOLUTION-MANAGER
Edit File: xmlParserContextFunction.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><title>R: Identifies function as expecting an xmlParserContext argument</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <link rel="stylesheet" type="text/css" href="R.css" /> </head><body> <table width="100%" summary="page for xmlParserContextFunction {XML}"><tr><td>xmlParserContextFunction {XML}</td><td style="text-align: right;">R Documentation</td></tr></table> <h2>Identifies function as expecting an xmlParserContext argument</h2> <h3>Description</h3> <p>This is a convenience function for setting the class of the specified function to include <code>"XMLParserContextFunction"</code>. This identifies it as expecting an <code>xmlParserCtxt</code> object as its first argument. The resulting function can be passed to the internal/native XML parser as a handler/callback function. When the parser calls it, it recognizes this class information and includes a reference to the C-level <code>xmlParserCtxt</code> object as the first argument in the call. </p> <p>This <code>xmlParserCtxt</code> object can be used to gracefully terminate the parsing (without an error), and in the future will also provide access to details about the current state of the parser, e.g. the encoding of the file, the XML version, whether entities are being replaced, line and column number for each node processed. </p> <h3>Usage</h3> <pre> xmlParserContextFunction(f, class = "XMLParserContextFunction") </pre> <h3>Arguments</h3> <table summary="R argblock"> <tr valign="top"><td><code>f</code></td> <td> <p>the function whose class information is to be augmented.</p> </td></tr> <tr valign="top"><td><code>class</code></td> <td> <p>the name of the class which is to be added to the <code>class</code> attribute of the function.</p> </td></tr> </table> <h3>Value</h3> <p>The function object <code>f</code> whose class attribute has been prepended with the value of <code>class</code>. </p> <h3>Author(s)</h3> <p>Duncan Temple Lang</p> <h3>See Also</h3> <p><code><a href="xmlTreeParse.html">xmlInternalTreeParse</a></code>/<code><a href="xmlTreeParse.html">xmlParse</a></code> and the <code>branches</code> parameter of <code><a href="xmlEventParse.html">xmlEventParse</a></code>. </p> <h3>Examples</h3> <pre> fun = function(context, ...) { # do things to parse the node # using the context if necessary. cat("In XMLParserContextFunction\n") xmlStopParser(context) } fun = xmlParserContextFunction(fun) txt = "<doc><a/></doc>" # doesn't work for xmlTreeParse() # xmlTreeParse(txt, handlers = list(a = fun)) # but does in xmlEventParse(). xmlEventParse(txt, handlers = list(startElement = fun), asText = TRUE) </pre> <hr /><div style="text-align: center;">[Package <em>XML</em> version 3.99-0.3 <a href="00Index.html">Index</a>]</div> </body></html>