struct StatusA UFormError never carries success or deferred; a Deferred call reports both.
Conforms to
Hashable, Sendable, CustomStringConvertible, EquatableUFormError is the only error the SDK throws, and every method says so with throws(UFormError), so a catch reads error.status with no cast. Status has one constant per uform_status_*_k of the C interface, and its description spells it as the library does, like invalid-argument.
do {
_ = try Model.loadRam(path: "missing.safetensors")
} catch {
print(error.status, error.message) // io The checkpoint could not be opened for reading
}Scalar, Mood and every other closed set read a spelling back with init?(name:), and nil for one the library does not spell.
API
StructStatusWhat went wrong, in the vocabulary the library and every binding share - one constant per uform_status_*_k, carrying the C enumerator itself.17
successThe call succeeded and carries no message.
static let success: StatusdeferredThe call was submitted deferred and is not final yet.
static let deferred: StatusoutOfMemoryDevice, pinned or host memory could not be allocated.
static let outOfMemory: StatusshapeMismatchItem counts, a pixel shape or a batch envelope disagree with the call or the model.
static let shapeMismatch: StatusunsupportedLayoutA stride or packing the model cannot read.
static let unsupportedLayout: StatusunknownKindA scalar, modality or name this build does not know.
static let unknownKind: StatusioA checkpoint file could not be opened, read or written.
static let io: StatusdeviceThe driver refused or the device faulted.
static let device: StatusmalformedSupplied bytes could not be decoded.
static let malformed: StatusinternalThe library reported neither success nor a failure.
static let `internal`: StatusconfigMismatchThe request contradicts a frozen configuration.
static let configMismatch: StatuscontendedA call was refused rather than waited for - a full deferred table, or an arena serving another call.
static let contended: StatuscancelledA progress handler asked the call to stop; it unwound and published nothing.
static let cancelled: StatusunsupportedThe verb is declared, but this residency or model does not implement it.
static let unsupported: StatusinvalidArgumentAn argument breaks the verb's contract.
static let invalidArgument: StatusdescriptionThe status as the library spells it, like invalid-argument.
initReads a spelling back, and nil for one no status carries.
StructUFormErrorOne failed call: a status every caller can branch on, and the detail the status cannot carry.3
statusThe failure identity, shared with every other SDK.
let status: StatusmessageThe library's static detail, or this binding's own when it refused the call.
let message: StringdescriptionThe status and message, as uform: <status>: <message>.
var description: String { get }