Difference between revisions of "Fetch Module"

From BaseX Documentation
Jump to navigation Jump to search
Line 1: Line 1:
This [[Module Library|XQuery Module]] provides functions to fetch the content of resources identified by URIs. For example, it fetches the content of file or http resources. The module is very similar to [http://www.zorba-xquery.com/html/modules/zorba/io/fetch Zorba’s Fetch Module].
+
This [[Module Library|XQuery Module]] provides functions to fetch the content of resources identified by URIs. For example, it fetches the content of file or http resources. The module has been inspired by [http://www.zorba-xquery.com/html/modules/zorba/io/fetch Zorba’s Fetch Module].
  
 
=Functions=
 
=Functions=

Revision as of 23:35, 2 January 2013

This XQuery Module provides functions to fetch the content of resources identified by URIs. For example, it fetches the content of file or http resources. The module has been inspired by Zorba’s Fetch Module.

Functions

fetch:content

Signatures fetch:content($uri as xs:string) as xs:string
fetch:content($uri as xs:string, $encoding as xs:string) as xs:string
Summary Fetches the resource referred to by the given URI and returns it as string.
Errors FODC0001: the URI could not be resolved, or the resource could not be retrieved.
FODC0002: the specified encoding is not supported, or unknown.
Examples
  • fetch:content("http://en.wikipedia.org") returns a string representation of the English Wikipedia main HTML page.

fetch:content-binary

Signatures fetch:content-binary($uri as xs:string) as xs:string
Summary Fetches the resource referred to by the given URI and returns it as base64Binary.
Errors FODC0001: the URI could not be resolved, or the resource could not be retrieved.
Examples
  • fetch:content-binary("http://www.ngdc.noaa.gov/mgg/image/color_etopo1_ice_low.jpg") returns the addressed image.

Errors

Code Description
BXFE0001 The URI could not be resolved, or the resource could not be retrieved.
BXFE0002 The specified encoding is not supported, or unknown.

Changelog

The module was introduced with Version 7.5.1.