Bureaucrats, editor, reviewer, Administrators
13,550
edits
Changes
Jump to navigation
Jump to search
As the original specifications are rather bulky and meticulous, we tried our best to make this overview comprehensible to a widerrange of readers. The following tables list the error codes thatare known to BaseX, a short description, and examples of queriesraising that errors. Errors that are specific to BaseX can be found in the descriptions of the respective [[Module Library|modules]].
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|BASXXPST}}, {{Code|XQST}}
==Type Errors==
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|XPTY}}, {{Code|XQTY}}
==Dynamic Errors==
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|XPDY}}, {{Code|XQDY}}
==Functions Errors==
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|FOAR}}, {{Code|FOCA}}, {{Code|FOCH}}, {{Code|FODC}}, {{Code|FODF}}, {{Code|FODT}}, {{Code|FOER}}, {{Code|FOFD}}, {{Code|FONS}}, {{Code|FORG}}, {{Code|FORX}}, {{Code|FOTY}}, {{Code|FOUT}}
==Serialization Errors==
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|SEPM}}, {{Code|SERE}}, {{Code|SESU}}
|
|- valign="top" scope="row"
|<code>SEPM0017</code>
| The definition of serialization parameter is invalid.
==Update Errors==
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|FOUP}}, {{Code|XUDY}}, {{Code|XUST}}, {{Code|XUTY}}
==Full-Text Errors==
Error * Namespace URI: <code><nowiki>http://www.w3.org/2005/xqt-errors</nowiki></code>* Namespace prefix: <code>err</code>* Codes: {{Code|FTDY}}, {{Code|FTST}}
no edit summary
This article is part of the [[XQuery|XQuery Portal]].It summarizes all error the codes of errors that may be thrown are raised by the BaseX standard features and functions of XQuery processor. As the original specifications are pretty comprehensive, we tried our best to make this overview comprehensible to a wider range of readers.
Original definitions of the error codes are found in the[httphttps://www.w3.org/TR/xquery-30/ XQuery 3.0],[httphttps://www.w3.org/TR/xpath-functions-3031/ XQuery 3.0 Functions],[httphttps://www.w3.org/TR/xquery-update-10/ XQuery 1.0 Update],[httphttps://www.w3.org/TR/xpath-full-text-10/ XQuery 1.0 Full Text],and [http://www.expath.org/spec/http-client EXPath HTTP]Specifications.
==BaseX Static Errors==
{| class="wikitable" width="100%"
! width="5%"|Code! width="60%"|Description! width="35%"|Examples|- valign="top" scope="row"|<code>BASX0000</code>| Generic error, which is used for exceptions in [[Java Bindings#Context-Awareness|context-aware Java bindings]].||- valign="top" scope="row"|<code>BASX0001</code>| The current user has insufficient [[User Management|permissions]] to execute an expression.|<code>file:delete('file.txt')</code>: ''Create'' rights needed.|- valign="top" scope="row"|<code>BASX0002</code>| The specified database option is unknown.|<code>declare option db:xyz "no"; 1</code>|} Additional, module-specific error codes are listed in the descriptions of the query modules. ==Static Errors== Error Codes: {{Code|XPST}}, {{Code|XQST}} {| class="wikitable" width="100%"! width="5%110"|Code! width="6050%"|Description! width="45%"|Examples
|- valign="top" scope="row"
|<code>XPST0003</code>
|An error occurred while ''parsing'' the query string (i.e., before the query could be compiled and executed). This error is the most common one, and may be accompanied by a variety of different error messages.
|<code>1+<hrbr/>for i in //* return $i</code>
|- valign="top" scope="row"
|<code>XPST0005</code>
|An expression will never return any results, no matter what input will be processedis provided.
|<code>doc('input')/..</code>
|- valign="top" scope="row"
|<code>XPST0008</code>
|A variable or type name is used that has not been defined in the current scope.
|<code>$a---<hrbr/>element(*, x)</code>
|- valign="top" scope="row"
|<code>XPST0017</code>
| • The specified function is unknown, or<br />• it uses the wrong number of arguments, or, when calling Java functions:<br />• there is more than one function with the same number of arguments.|<code>unknown()<hrbr/>count(1,2,3)</code>
|- valign="top" scope="row"
|<code>XPST0051</code>
| An unknown QName is used in a ''sequence type'' (e.g. in the target type of the {{Code|cast}} expression).
|<code>1 instance of x<hrbr/>"test" cast as xs:itr</code>
|- valign="top" scope="row"
|<code>XPST0080</code>
|<code>XPST0081</code>
| • A QName uses a prefix that has not been bound to any namespace, or<br />• a pragma or option declaration has not been prefixed.
|<code>unknown:x<hrbr/>(# pragma #) { 1 }</code>
|-
| colspan=3 style="background-color:white;"|
|<code>declare context item ...</code>
|- valign="top" scope="row"
|<code>XQST0107XQST0106</code>| The initializer of the context item depends on itselfAn annotation has been declared twice in a variable or function declaration.|<code>declare context item := %updating %updating function ...; ()</code>
|- valign="top" scope="row"
|<code>XQST0108</code>
|}
{| class="wikitable" width="100%"
! width="5%110"|Code! width="6050%"|Description! width="45%"|Examples
|- valign="top" scope="row"
|<code>XPTY0004</code>
| This error is raised if an expression has the wrong type, or cannot be cast into the specified type. It may be raised both statically (during query compilation) or dynamically (at runtime).
|<code>1 + "A"<hrbr/>abs("a")<hrbr/>1 cast as xs:gYear</code>
|- valign="top" scope="row"
|<code>XPTY0018</code>
| An attribute node cannot be bound to its parent element, as other nodes of a different type were specified before.
|<code><elem>text { attribute a { "val" } }</elem></code>
|- valign="top" scope="row"
|<code>XQTY0105</code>
| A function item has been specified as content of an element.
|<code><X>{ false#0 }</X></code>
|}
{| class="wikitable" width="100%"
! width="5%110"|Code! width="6050%"|Description! width="35%"|Examples
|- valign="top" scope="row"
|<code>XPDY0002</code>
| • No value has been defined for an external variable, or<br />• no context item has been set before the query was executed.
|<code>declare variable $x external; $x<hrbr/>descendant::*</code>
|- valign="top" scope="row"
|<code>XPDY0050</code>
| • The operand type of a {{Code|treat}} expression does not match the type of the argument, or<br/>• the root of the context item must be a document node.
|<code>"string" treat as xs:int<hrbr/>"string"[/]</code>
|-
| colspan=3 style="background-color:white;"|
|<code>processing-instruction { "1" } { "" }</code>
|- valign="top" scope="row"
|<code>XQDY0043XQDY0044</code>
| The node name of an attribute uses reserved prefixes or namespaces.
|<code>attribute xmlns { "etc" }</code>
| The node name of an element uses reserved prefixes or namespaces.
|<code>element { QName("uri", "xml:n") } {}</code>
|- valign="top" scope="row"
|<code>XQDY0101</code>
| Invalid namespace declaration.
|<code>namespace xmlns { 'x' }</code>
|- valign="top" scope="row"
|<code>XQDY0102</code>
| Duplicate namespace declaration.
|<code>element x { namespace a {'b'}, namespace a {'c'} }</code>
|}
{| class="wikitable" width="100%"
! width="5%110"|Code! width="50%"|Description! width="45%"|Examples
|- valign="top" scope="row"
|<code>FOAR0001</code>
|<code>FOAR0002</code>
| A numeric declaration or operation causes an over- or underflow.
|<code>12345678901234567890<hrbr/>xs:double("-INF") idiv 1</code>
|-
| colspan=3 style="background-color:white;"|
|<code>FOCA0002</code>
| • A float number cannot be converted to a decimal or integer value, or<br />• a function argument cannot be converted to a valid QName.
|<code>xs:int(xs:double("INF"))<hrbr/>QName("", "el em")</code>
|- valign="top" scope="row"
|<code>FOCA0003</code>
|-
| colspan=3 style="background-color:white;"|
|- valign="top" scope="row"
|<code>FODT0001</code>
| An arithmetic duration operation causes an over- or underflow.
|<code>xs:date('2000-01-01') + xs:duration('P99999Y')</code>
|- valign="top" scope="row"
|<code>FODT0002</code>
|<code>FORG0001</code>
| A value cannot be cast to the required target type.
|<code>xs:integer("A")<hrbr/>1 + <x>a</x></code>
|- valign="top" scope="row"
|<code>FORG0002</code>
|}
{| class="wikitable" width="100%"
! width="5%110"|Code! width="50%"|Description! width="45%"|Examples
|- valign="top" scope="row"
|<code>SESU0007</code>
| A specified parameter is unknown or has an invalid value.
|<code>declare option output:indent "nope"; 1</code>
|
|}
{| class="wikitable" width="100%"
! width="5%110"|Code! width="50%"|Description! width="45%"|Examples
|- valign="top" scope="row"
|<code>FOUP0001</code>
|}
{| class="wikitable" width="100%"
! width="5%110"|Code! width="50%"|Description! width="45%"|Examples
|- valign="top" scope="row"
|<code>FTDY0016</code>
|}
=BaseX Errors= * Namespace URI: <code><nowiki>http://basex.org</nowiki></code>* Namespace prefix: <code>basex</code> {| class="wikitable" width="100%"! width="110"|Code!Description!Examples|- valign="top" scope="row"|<code>annotation</code>| Annotation errors.|<code>%basex:xyz function() { 123 }</code>|- valign="top" scope="row"|<code>doc</code>| The argument specified via fn:doc must yield a single document.|<code>doc('db-collection')</code>|- valign="top" scope="row"|<code>error</code>| Generic error, which is e. g. raised by [[CategoryJava Bindings#Integration|Java bindings]].|<code>import module namespace qm='java:XQueryorg.basex.query.func.QueryModuleTest';<br/>qm:error()</code>|- valign="top" scope="row"|<code>function</code>| Function items cannot be cached.|<code>db:output(true#0)</code>|- valign="top" scope="row"|<code>http</code>| The function was called outside an HTTP servlet context.|<code>session:get('abc')</code>|- valign="top" scope="row"|<code>options</code>| The specified database option is unknown.|<code>declare option db:xyz 'no'; 1</code>|- valign="top" scope="row"|<code>overflow</code>| Stack overflow.|<code>declare function local:a() { local:b() + 1 };<br/>declare function local:b() { local:a() + 2 };<br/>local:a()</code>|- valign="top" scope="row"|<code>permission</code>| The current user has insufficient [[User Management|permissions]] to open a database, update nodes, etc.|<code>db:open('admin')</code>|- valign="top" scope="row"|<code>restxq</code>| Errors related to [[RESTXQ]].|<code>%restxq:GET('x')</code>|- valign="top" scope="row"|<code>update</code>| BaseX-specific update errors.|<code><a/> update db:output('bla')</code>|} Additional, module-specific error codes are listed in the descriptions of the query modules.
