Difference between revisions of "Index Module"

From BaseX Documentation
Jump to navigation Jump to search
Line 79: Line 79:
 
===Version 7.3===
 
===Version 7.3===
  
* Updates: [[#index:texts|index:texts]], [[#index:attributes|index:attributes]]: Signature with three arguments added.
+
* Updated: [[#index:texts|index:texts]], [[#index:attributes|index:attributes]]: Signature with three arguments added.
  
 
The module was introduced with {{Version|7.1}}.
 
The module was introduced with {{Version|7.1}}.
  
 
[[Category:XQuery]]
 
[[Category:XQuery]]

Revision as of 21:23, 27 May 2012

This XQuery Module provides functions for displaying information stored in the database index structures.

Conventions

All functions in this module are assigned to the http://basex.org/modules/index namespace, which is statically bound to the index prefix.
All errors are assigned to the http://basex.org/errors namespace, which is statically bound to the bxerr prefix.

Functions

index:facets

Signatures index:facets($db as item()) as xs:string
index:facets($db as item(), $type as xs:string) as xs:string
Summary Returns information about possible facets and facet values of the database node $db in document structure format.
If $type is specified as flat, the function returns this information in a flat summarized version.
Examples
  • index:facets("DB") returns information about facets and facet values on the database DB in document structure.
  • index:facets("DB", "flat") returns information about facets and facet values on the database DB in a summarized flat structure.

index:texts

Template:Mark: Signature with three arguments added.

Signatures index:texts($db as item()) as element(value)*
index:texts($db as item(), $prefix as xs:string) as element(value)*
index:texts($db as item(), $start as xs:string, $ascending as xs:boolean) as element(value)*
Summary Returns all strings stored in the text index of the database node $db, along with their number of occurrences.
If $prefix is specified, the returned nodes will be refined to the strings starting with that prefix.
If $start and $ascending are specified, all nodes will be returned after or before the specified start text.
Errors BXDB0004: the text index is not available.

index:attributes

Template:Mark: Signature with three arguments added.

Signatures index:attributes($db as item()) as element(value)*
index:attributes($db as item(), $prefix as xs:string) as element(value)*
index:attributes($db as item(), $start as xs:string, $ascending as xs:boolean) as element(value)*
Summary Returns all strings stored in the attribute index of the database node $db, along with their number of occurrences.
If $prefix is specified, the returned nodes will be refined to the strings starting with that prefix.
If $start and $ascending are specified, all nodes will be returned after or before the specified start text.
Errors BXDB0004: the attribute index is not available.

index:element-names

Signatures index:element-names($db as item()) as element(value)*
Summary Returns all element names stored in the index of the database node $db, along with their number of occurrences.

index:attribute-names

Signatures index:attribute-names($db as item()) as element(value)*
Summary Returns all attribute names stored in the index of the database node $db, along with their number of occurrences.

Changelog

Version 7.3

The module was introduced with Version 7.1.