Errors | UForm for C

Statuses are numbered as USearch numbers them, so a failure keeps its identity across the two libraries:

uform_status_out_of_memory_k: host, pinned or device memory ran out, or the scratch ceiling is too low.
uform_status_shape_mismatch_k and uform_status_unsupported_layout_k: counts, shapes or strides the model cannot read.
uform_status_malformed_k and uform_status_io_k: bytes that do not decode, or a file that does not open, read or write.
uform_status_device_k: the driver refused, a device faulted, or an executor and a model or arena disagree on residency.
uform_status_unknown_kind_k: a scalar, modality or name this build does not know.
uform_status_unsupported_k: a verb, modality or class this model or build does not serve.
uform_status_invalid_argument_k and uform_status_config_mismatch_k: an argument breaking the verb’s contract, or a request contradicting a frozen configuration.
uform_status_contended_k and uform_status_cancelled_k: a call refused rather than waited for, or stopped by its progress handler.
uform_status_internal_k: a defect, reported rather than hung on.

uform_status_name spells a status as lowercase words joined by dashes and uform_status_from_name reads it back, as the other closed sets’ _name and _from_name pairs do.

API

Types

uform_status_tWhat went wrong, numbered as USearch numbers it, so one failure carries one identity across the two libraries and every binding that validates before calling them.

types.h:185 ↗

enum uform_status_t

Values USearch spends on index states UForm has no counterpart for - a read-only handle, an exhausted ID space, an uninitialized reservation - stay unused here rather than renumbered.

Statuses fall into five categories. Resources: uform_status_out_of_memory_k, uform_status_io_k and uform_status_device_k. Input: uform_status_shape_mismatch_k, uform_status_unsupported_layout_k, uform_status_unknown_kind_k, uform_status_malformed_k and uform_status_invalid_argument_k. State: uform_status_config_mismatch_k, uform_status_contended_k and uform_status_unsupported_k. Interruptions: uform_status_cancelled_k and uform_status_deferred_k. Defects: uform_status_internal_k. Any verb that allocates, binds a device or touches a file may also return a Resources status; any verb taking a progress callback may return uform_status_cancelled_k. A verb's own block lists only what its contract adds.

Values

`uform_status_success_k`	`0`	The call completed; `message` carries nothing.
`uform_status_deferred_k`	`1`	The call was submitted deferred and is not final yet; the one non-final status.
`uform_status_out_of_memory_k`	`2`	Device, pinned, or host memory could not be allocated, or the executor's scratch ceiling is too low.
`uform_status_shape_mismatch_k`	`3`	Item counts, a pixel shape, or a batch envelope disagree with the call or the model.
`uform_status_unsupported_layout_k`	`4`	A stride or packing the model cannot read.
`uform_status_unknown_kind_k`	`5`	A scalar, modality, or name this build does not know.
`uform_status_io_k`	`7`	A checkpoint file could not be opened, read, or written.
`uform_status_device_k`	`8`	The driver refused or the device faulted; after a fault the executor refuses every later call.
`uform_status_malformed_k`	`9`	Supplied bytes could not be decoded: a checkpoint, an image, a clip, or a recording.
`uform_status_internal_k`	`10`	The library reported neither success nor a failure - a contract violation, so it names a defect.
`uform_status_config_mismatch_k`	`13`	The request contradicts a frozen configuration, like resuming a checkpoint of another geometry.
`uform_status_contended_k`	`14`	The call was refused rather than waited for, like a submission to a full deferred table, or a blocking call from inside a callback of the executor it would wait on.
`uform_status_cancelled_k`	`15`	A progress handler asked the call to stop; it unwound and published nothing.
`uform_status_unsupported_k`	`16`	The verb is declared for every residency or model, but this one does not implement it, like a modality the model was not trained on; no retry or smaller request can help.
`uform_status_invalid_argument_k`	`17`	An argument breaks the verb's contract - a required pointer left `NULL`, inputs inside the arena the call rewinds, a name no table spells.

Spellings

char const * uform_status_name(uform_status_t status);

uform_status_t uform_status_from_name(uform_bytes_view_t name);