administrator, editor
33
edits
Changes
Jump to navigation
Jump to search
m
* as map, which contains all key/value pairs===Specifying Options=== The next query creates an XML document with namespaces: ;Query:<pre class="brush:xmlxquery">map { html:parse("key1" :<a href= "value1'ok.html'/>", ... map { 'nons': false() })
|-| '''Errors'''|{{Error|BXHL0001|#Errors}} the input cannot be converted to XML.|-| '''Examples'''|* {{Code|html:parse("<html></html>")}} returns {{Code|<html/>}}* <code><nowiki>html:parse("<a href='ok.html'/>", map { 'nons' := true() })</nowiki></code> creates an XML document without namespaces. It returns;Result:
* ===Parsing Binary Input=== If the input encoding is unknown, the data to be processed can be passed on in its binary representation.The HTML parser will automatically try to detect the correct encoding: ;Query:<code><nowikipre class="brush:xquery">html:parse(fetch:content-binary("httphttps://en.wikipedia.org"))</nowikipre> ;Result:<pre class="brush:xml"><html xmlns="http://www.w3.org/code1999/xhtml" class="client-nojs" dir="ltr" lang="en"> returns an XML representation of <head> <title>Wikipedia, the English Wikipedia main pagefree encyclopedia</title> <meta charset="UTF-8"/> .. The input is passed on its binary representation such that the HTML parser can automatically detect the correct encoding.|}</pre>
The module was introduced with ;Version 7.5.19.0 * Updated: error codes updated; errors now use the module namespace
[[Category:XQuery]]The module was introduced with Version 7.6.
Made link to Wikipedia HTTPS for binary example - as HTTP returns nothing
This [[Module Library|XQuery Module]] provides functions for converting HTML to XML. The input Conversion will only be converted take place if [http://home.ccil.org/~cowan/XML/tagsoup/ TagSoup] is included in the classpath (see [[Parsers#HTML Parser|HTML Parsing]] for more details).
=Conventions=
All functions and errors in this module are assigned to the {{Code|<code><nowiki>http://basex.org/modules/html}} </nowiki></code> namespace, which is statically bound to the {{Code|html}} prefix.<br/>All errors are assigned to the {{Code|http://basex.org/errors}} namespace, which is statically bound to the {{Code|bxerr}} prefix.
=Functions=
{| width='100%'
|-
| width='90120' | '''Signatures'''
|{{Code|'''html:parser'''() as xs:string}}<br />
|-
{| width='100%'
|-
| width='90120' | '''Signatures'''|{{Func|html:parse|$input as xs:anyAtomicType|document-node()}}<br />{{Func|html:parse|$input as xs:anyAtomicType, $options as itemmap(*)?|document-node()}}<br />
|-
| '''Summary'''
|Converts the HTML document specified by {{Code|$input}} to XML, and returns a document node. :<br/>* The input may either be a string or a binary item (xs:hexBinary, xs:base64Binary). * If the input is passed on in its binary representation, the HTML parser will try to automatically choose the correct encoding.<br/> The {{Code|$options}} argument can be used to set [[Parsers#TagSoup Options|TagSoup optionsOptions]]. It can |-| '''Errors'''|{{Error|parse|#Errors}} the input cannot be converted to XML.|} =Examples= ===Basic Example=== The following query converts the specifiedstring to an XML document node. ;Query:<br /pre class="brush:xquery">* as children of an {{Code|html:parse("<html:options>")</pre>}} element ; e.g.Result:
<pre class="brush:xml">
<htmlxmlns="http:options> <html:key1 value='value1'/> /www.w3..<org/1999/xhtml"/html:options>
</pre>
</pre>
<pre class="brush:xml">
<htmlxmlns="http://www.w3.org/1999/xhtml">
<body>
<a shape="rect" href="ok.html"/>
</html>
</pre>
=Errors=
{| width='100%' class="wikitable" width="100%"! width="5%110"|Code! width="95%"|Description
|-
|{{Code|BXHL0001parse}}
|The input cannot be converted to XML.
|}
=Changelog=
