This is the ThingsDB documentation for version v0, click here for the latest version!

Errors

ThingsDB uses the following error codes:

Error Code Meaning
cancelled_err -64 Operation is cancelled before completion.
operation_err -63 Operation is not valid in the current context.
num_arguments_err -62 Wrong number of arguments.
type_err -61 Object of inappropriate type.
value_err -60 Object has the right type but an inappropriate value.
overflow_err -59 Integer is too large to fit a 64 bit signed integer.
zero_div_err -58 Trying a division or modulo by zero.
max_quota_err -57 Some quota limit is reached.
auth_err -56 Wrong credentials or a request while the connection is not authenticated.
forbidden_err -55 You lack the privileges to do the request.
lookup_err -54 Requested resource not found or index out of range.
bad_data_err -53 Invalid data, for example an invalid data type used in a query.
syntax_err -52 Syntax error in the query.
node_err -51 At least one node has an issue while processing the request.
assert_err -50 Assertion statement has failed.

Internal errors

Error Code Meaning
RESULT_TOO_LARGE -6 Result size limit is exceeded. See the configuration page to configure this limit.
REQUEST_TIMEOUT -5 Timeout during this request.
REQUEST_CANCEL -4 A request is cancelled.
WRITE_UV -3 Write to stream error.
MEMORY -2 Memory allocation error.
INTERNAL -1 General internal error.

Custom errors

The range -127 .. -100 is reserved by ThingsDB for custom error codes although technically this range can be extended from -127 up to -64. See err(..) and alt_raise(..) for more information on how to use custom error codes.