Bureaucrats, editor, reviewer, Administrators
13,550
edits
Changes
Jump to navigation
Jump to search
==db:get==
→Read Operations
=Read Operations=
==db:get==
{{Announce|Updated with Version 10:}} Renamed (before: {{Code|db:open}}). Due to its popularity, the old function name will be supported for some more time.
{| width='100%'
|-
| '''Summary'''
|Opens Returns all documents from the database {{Code|$db}} and returns all document nodes.<br/>The document nodes to be returned can be filtered with , or only documents matching the specified {{Code|$path}} argument.
|-
| '''Errors'''
|-
| '''Summary'''
|Opens Returns all nodes from the database {{Code|$db}} and returns all distinct nodes with the pre values {{Code|$pres}} in [[Utility Module#util:ddo|distinct document order]].<br/>The [[Node Storage#PRE Value|PRE value]] provides very fast access to an existing database node, but it will change whenever a node with a smaller ''pre'' values is added to or deleted from a database.
|-
| '''Errors'''
==db:get-id==
{{Announce|Updated with Version 10:}} Renamed (before: {{Code|db:getopen-id}}).
{| width='100%'
|-
| '''Summary'''
|Opens Returns all nodes from the database {{Code|$db}} and returns all distinct nodes with the specified pre values {{Code|$ids}} in [[Utility Module#util:ddo|distinct document order]].<br />Each database node has a ''persistent'' [[Node Storage#ID Value|ID value]]. Access to the node id ID can be sped up by turning on the {{Option|UPDINDEX}} option.
|-
| '''Errors'''
|{{Error|open|#Errors}} the addressed database does not exist or could not be opened.<br/>{{Error|range|#Errors}} the specified id ID value does not exist in the database.
|}
