Fetch Module - Revision history

CG: Text replacement - "" to "

2023-12-01T16:34:28Z

Text replacement - "<syntaxhighlight lang="xquery">" to "<pre lang='xquery'>"

CG: Text replacement - "" to ""

2023-12-01T16:30:11Z

Text replacement - "</syntaxhighlight>" to "</pre>"

CG at 12:52, 31 October 2023

2023-10-31T12:52:51Z

CG at 15:10, 9 March 2023

2023-03-09T15:10:29Z

CG at 15:07, 9 March 2023

2023-03-09T15:07:21Z

CG at 14:48, 9 March 2023

2023-03-09T14:48:26Z

CG at 13:28, 9 March 2023

2023-03-09T13:28:18Z

CG: Text replacement - "'''Signatures'''" to "'''Signature'''"

2023-03-09T13:08:32Z

Text replacement - "'''Signatures'''" to "'''Signature'''"

CG at 11:04, 9 March 2023

2023-03-09T11:04:59Z

CG at 12:17, 20 July 2022

2022-07-20T12:17:57Z

@@ Line 78: / Line 78: @@
+|
 * Retrieve an XML representation of the English Wikipedia main HTML page with whitespace stripped:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 fetch:doc("http://en.wikipedia.org", map { 'stripws': true() })
 </pre>
 * Return a web page as XML, preserve namespaces:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 fetch:doc(
    'http://basex.org/',
@@ Line 109: / Line 109: @@
+|
 * Retrieves file input as binary data and parses it as XML:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 fetch:binary-doc(file:read-binary('doc.xml'))
 </pre>
 * Encodes a string as CP1252 and parses it as XML. The input and the string {{Code|touché}} will be correctly decoded because of the XML declaration:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 fetch:binary-doc(convert:string-to-base64(
    "<?xml version='1.0' encoding='CP1252'?><xml>touché</xml>",
@@ Line 120: / Line 120: @@
 </pre>
 * Encodes a string as UTF-16 and parses it as XML. The document will be correctly decoded, as the first bytes of the data indicate that the input must be UTF-16:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 fetch:binary-doc(convert:string-to-base64("<xml/>", "UTF16"))
 </pre>

@@ Line 80: / Line 80: @@
 <syntaxhighlight lang="xquery">
 fetch:doc("http://en.wikipedia.org", map { 'stripws': true() })
-</syntaxhighlight>
+</pre>
 * Return a web page as XML, preserve namespaces:
 <syntaxhighlight lang="xquery">
@@ Line 90: / Line 90: @@
+   }
+)
-</syntaxhighlight>
+</pre>
 |}
@@ Line 111: / Line 111: @@
 <syntaxhighlight lang="xquery">
 fetch:binary-doc(file:read-binary('doc.xml'))
-</syntaxhighlight>
+</pre>
 * Encodes a string as CP1252 and parses it as XML. The input and the string {{Code|touché}} will be correctly decoded because of the XML declaration:
 <syntaxhighlight lang="xquery">
@@ Line 118: / Line 118: @@
    "CP1252"
 ))
-</syntaxhighlight>
+</pre>
 * Encodes a string as UTF-16 and parses it as XML. The document will be correctly decoded, as the first bytes of the data indicate that the input must be UTF-16:
 <syntaxhighlight lang="xquery">
 fetch:binary-doc(convert:string-to-base64("<xml/>", "UTF16"))
-</syntaxhighlight>
+</pre>
 |- valign="top"
 | '''Errors'''

@@ Line 68: / Line 68: @@
 | '''Summary'''
 |Fetches the resource referred to by the given {{Code|href}} string and returns it as a document node.<br/>The {{Code|$options}} argument can be used to change the parsing behavior. Allowed options are all [[Options#Parsing|parsing]] and [[Options#XML Parsing|XML parsing]] options in lower case.<br/>The function differs from {{Code|fn:doc}} in various aspects:
-* It is ''non-deterministic'', i.e., a new document node will be created by each call of this function.
+* It is ''nondeterministic'', i.e., a new document node will be created by each call of this function.
 * A document created by this function will be garbage-collected as soon as it is not referenced anymore.
 * URIs will not be resolved against existing databases. As a result, it will not trigger any locks (see [[Transaction Management#Limitations|limitations of database locking]] for more details).

@@ Line 15: / Line 15: @@
 | width='120' | '''Signature'''
 |<pre>fetch:binary(
-   $uri  as xs:string
+   $href  as xs:string
 ) as xs:base64Binary</pre>
 |- valign="top"
 | '''Summary'''
-|Fetches the resource referred to by the given URI and returns it as [[Lazy Module|lazy]] {{Code|xs:base64Binary}} item.
+|Fetches the resource referred to by the given {{Code|href}} string and returns it as [[Lazy Module|lazy]] {{Code|xs:base64Binary}} item.
 |- valign="top"
 | '''Errors'''
@@ Line 36: / Line 36: @@
 | width='120' | '''Signature'''
 |<pre>fetch:text(
-   $uri       as xs:string,
+   $href      as xs:string,
    $encoding  as xs:string    := (),
    $fallback  as xs:boolean?  := false()
@@ Line 42: / Line 42: @@
 |- valign="top"
 | '''Summary'''
-|Fetches the resource referred to by the given {{Code|$uri}} and returns it as [[Lazy Module|lazy]] {{Code|xs:string}} item:
+|Fetches the resource referred to by the given {{Code|href}} string and returns it as [[Lazy Module|lazy]] {{Code|xs:string}} item:
 * The UTF-8 default encoding can be overwritten with the optional {{Code|$encoding}} argument.
 * By default, invalid characters will be rejected. If {{Code|$fallback}} is set to true, these characters will be replaced with the Unicode replacement character <code>FFFD</code> (&#xFFFD;).
@@ Line 62: / Line 62: @@
 | width='120' | '''Signature'''
 |<pre>fetch:doc(
-   $uri      as xs:string,
+   $href     as xs:string,
    $options  as map(*)?    := map { }
 ) as document-node()</pre>
 |- valign="top"
 | '''Summary'''
-|Fetches the resource referred to by the given {{Code|$uri}} and returns it as a document node.<br/>The {{Code|$options}} argument can be used to change the parsing behavior. Allowed options are all [[Options#Parsing|parsing]] and [[Options#XML Parsing|XML parsing]] options in lower case.<br/>The function differs from {{Code|fn:doc}} in various aspects:
+|Fetches the resource referred to by the given {{Code|href}} string and returns it as a document node.<br/>The {{Code|$options}} argument can be used to change the parsing behavior. Allowed options are all [[Options#Parsing|parsing]] and [[Options#XML Parsing|XML parsing]] options in lower case.<br/>The function differs from {{Code|fn:doc}} in various aspects:
 * It is ''non-deterministic'', i.e., a new document node will be created by each call of this function.
 * A document created by this function will be garbage-collected as soon as it is not referenced anymore.
@@ Line 134: / Line 134: @@
 | width='120' | '''Signature'''
 |<pre>fetch:content-type(
-   $uri  as xs:string
+   $href  as xs:string
 ) as xs:string</pre>
 |- valign="top"
 | '''Summary'''
-|Returns the content-type (also called mime-type) of the resource specified by {{Code|$uri}}:
+|Returns the content-type (also called mime-type) of the resource specified by {{Code|href}} string:
 * If a remote resource is addressed, the request header will be evaluated.
 * If the addressed resource is locally stored, the content-type will be guessed based on the file extension.

@@ Line 37: / Line 37: @@
 |<pre>fetch:text(
    $uri       as xs:string,
-   $encoding  as xs:string   := (),
+   $encoding  as xs:string    := (),
-   $fallback  as xs:boolean  := ()
+   $fallback  as xs:boolean?  := false()
 ) as xs:string</pre>
 |- valign="top"