Difference between revisions of "Index Module"

From BaseX Documentation
Jump to navigation Jump to search
Line 19: Line 19:
 
|-
 
|-
 
|'''Errors'''
 
|'''Errors'''
|{{Error|db:open|XQuery Errors#BaseX Errors}} The addressed database does not exist or could not be opened.
+
|{{Error|db:open|Database Module#Errors}} The addressed database does not exist or could not be opened.
 
|-
 
|-
 
|'''Examples'''
 
|'''Examples'''
Line 38: Line 38:
 
|-
 
|-
 
|'''Errors'''
 
|'''Errors'''
|{{Error|db:open|XQuery Errors#BaseX Errors}} The addressed database does not exist or could not be opened.<br/>{{Error|db:no-index|Database Module#Errors}} the index is not available.
+
|{{Error|db:open|Database Module#Errors}} The addressed database does not exist or could not be opened.<br/>{{Error|db:no-index|Database Module#Errors}} the index is not available.
 
|}
 
|}
  
Line 52: Line 52:
 
|-
 
|-
 
|'''Errors'''
 
|'''Errors'''
|{{Error|db:open|XQuery Errors#BaseX Errors}} The addressed database does not exist or could not be opened.<br/>{{Error|db:no-index|Database Module#Errors}} the index is not available.
+
|{{Error|db:open|Database Module#Errors}} The addressed database does not exist or could not be opened.<br/>{{Error|db:no-index|Database Module#Errors}} the index is not available.
 
|}
 
|}
  
Line 66: Line 66:
 
|-
 
|-
 
|'''Errors'''
 
|'''Errors'''
|{{Error|db:open|XQuery Errors#BaseX Errors}} The addressed database does not exist or could not be opened.<br/>{{Error|db:no-index|Database Module#Errors}} the index is not available.
+
|{{Error|db:open|Database Module#Errors}} The addressed database does not exist or could not be opened.<br/>{{Error|db:no-index|Database Module#Errors}} the index is not available.
 
|}
 
|}
  
Line 80: Line 80:
 
|-
 
|-
 
|'''Errors'''
 
|'''Errors'''
|{{Error|db:open|XQuery Errors#BaseX Errors}} The addressed database does not exist or could not be opened.
+
|{{Error|db:open|Database Module#Errors}} The addressed database does not exist or could not be opened.
 
|}
 
|}
  
Line 94: Line 94:
 
|-
 
|-
 
|'''Errors'''
 
|'''Errors'''
|{{Error|db:open|XQuery Errors#BaseX Errors}} The addressed database does not exist or could not be opened.
+
|{{Error|db:open|Database Module#Errors}} The addressed database does not exist or could not be opened.
 
|}
 
|}
  

Revision as of 12:18, 21 November 2017

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 xs:string) as xs:string
index:facets($db as xs:string, $type as xs:string) as xs:string
Summary Returns information about all facets and facet values of the database $db in document structure format.
If $type is specified as flat, the function returns this information in a flat summarized version. The returned data is derived from the Path Index.
Errors db:open: The addressed database does not exist or could not be opened.
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

Signatures index:texts($db as xs:string) as element(value)*
index:texts($db as xs:string, $prefix as xs:string) as element(value)*
index:texts($db as xs:string, $start as xs:string, $ascending as xs:boolean) as element(value)*
Summary Returns all strings stored in the Text Index of the database $db, along with their number of occurrences.
If $prefix is specified, the returned entries will be refined to the ones starting with that prefix.
If $start and $ascending are specified, all nodes will be returned after or before the specified start entry.
Errors db:open: The addressed database does not exist or could not be opened.
db:no-index: the index is not available.

index:attributes

Signatures index:attributes($db as xs:string) as element(value)*
index:attributes($db as xs:string, $prefix as xs:string) as element(value)*
index:attributes($db as xs:string, $start as xs:string, $ascending as xs:boolean) as element(value)*
Summary Returns all strings stored in the Attribute Index of the database $db, along with their number of occurrences.
If $prefix is specified, the returned entries will be refined to the ones starting with that prefix.
If $start and $ascending are specified, all nodes will be returned after or before the specified start entry.
Errors db:open: The addressed database does not exist or could not be opened.
db:no-index: the index is not available.

index:tokens

Signatures index:tokens($db as xs:string) as element(value)*
Summary Returns all strings stored in the Token Index of the database $db, along with their number of occurrences.
Errors db:open: The addressed database does not exist or could not be opened.
db:no-index: the index is not available.

index:element-names

Signatures index:element-names($db as xs:string) as element(value)*
Summary Returns all element names stored in the Name Index of the database $db, along with their number of occurrences.
Errors db:open: The addressed database does not exist or could not be opened.

index:attribute-names

Signatures index:attribute-names($db as xs:string) as element(value)*
Summary Returns all attribute names stored in the Name Index of the database $db, along with their number of occurrences.
Errors db:open: The addressed database does not exist or could not be opened.

Changelog

Version 8.4
Version 7.7
  • Updated: the functions no longer accept Database Nodes as reference. Instead, the name of a database must now be specified.
Version 7.3

The module was introduced with Version 7.1.