Errors#

A call can fail because a definition is missing, a document is invalid, or the database refuses a change. The examples use the people data to show these results. Use the status and diagnostic fields to identify the failure.

Binding errors#

The error record gives the fields in your language. Statuses gives the failure conditions of each operation.

error#

This record describes a failure with its status and diagnostic. The binding copies the diagnostic before it releases the native owner.

Statuses#

Each status names a class of failure. The table lists codes from the binding. Native diagnostic codes can differ.

Status::INVALID_ARGUMENT#

Codes: time_out_of_range, invalid_argument, out_of_range, non_finite_number, cycle, unsupported_type, too_large, native_failure, live_children, wrong_kind, not_integral, inexact_number, missing_field, unknown_field, duplicate_field, too_deep, length_mismatch, malformed_tag, ambiguous_field, ambiguous_variant, invalid_value, hook_failed.

Status::INVALID_JSON#

Status::COMPILE_FAILED#

Status::EVALUATION_FAILED#

Status::OUT_OF_MEMORY#

Codes: out_of_memory.

Status::NOT_FOUND#

Codes: not_found.

Status::LOCKED#

Status::CONFLICT#

Status::INVALID_DEFINITION#

Status::SCHEMA_VIOLATION#

Status::INVALID_COMMIT_TIME#

Status::CLOSED#

Codes: closed.

Status::REJECTED#

Status::UNSUPPORTED#

Codes: abi_version, core_digest.

Status::CANCELLED#

Codes: cancelled.

No core operation reports this status.

Status::TIMEOUT#

Status::UNAVAILABLE#

Status::FAILED#

Status::UNLICENSED#

Codes: unlicensed.

Refusal examples#

The generator captured each result from the native library.

Describe the backup runtime#

let result = db.backups().status().err();

Wait until every target stored the history#

let sync_options = stardust::parse("{maxWait {#dur PT5S}}", Format::DUST)?;
let result = db.backups().sync(Some(&sync_options)).err();

convert#

edn_text holds this document:

let edn = stardust::parse(edn_text, Format::TRON)?;
let output = edn.read(edn.root()?)?.text;
let result = stardust::parse(output, Format::EDN).err();

Refuse a metadata-only transaction#

patch_text holds this document:

let patch = stardust::parse(patch_text, Format::TRON)?;
let result = db.merge_patch(&patch, None).err();

Refuse a repeated commit time#

future_text holds this document:

older_text holds this document:

let future = stardust::parse(future_text, Format::TRON)?;
db.merge_patch(&future, None)?;
let older = stardust::parse(older_text, Format::TRON)?;
let result = db.merge_patch(&older, None).err();

Refuse an invalid query definition#

query_text holds this document:

let definition = stardust::parse(query_text, Format::TRON)?;
let result = db.query(&definition).err();

Report a missing stored query#

let result = db.query("people/missing").err();

Report a malformed byte at offset zero#

malformed holds these bytes:

]

let result = stardust::parse(malformed, Format::DUST).err();

Report malformed DUST#

malformed holds these bytes:

[

let result = stardust::parse(malformed, Format::DUST).err();