GALANTHUS / ABI FUNCTION REFERENCE
gln_remove_continuation
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API gln_status_t GLN_CALL gln_remove_continuation(
gln_continuation_store_t* in_store,
const char* in_id,
int* out_removed_or_null,
gln_error_t* out_error);
Purpose
Removes the continuation stored under caller-supplied in_id from a continuation store.
out_removed_or_null is optional. When supplied, it receives nonzero if an entry was removed and zero when no entry existed.
Nullable parameter slots (out_removed_or_null, out_error) may be passed as NULL; all other non-value parameters follow the nullability shown in the table.
Return
Returns GLN_OK on success and a non-OK gln_status_t value on failure.
| Type | Nullability | Ownership |
|---|---|---|
gln_status_t | value | value |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_store | input | gln_continuation_store_t* | nonnull | borrowed |
in_id | input | const char* | nonnull | borrowed |
out_removed_or_null | output | int* | nullable | caller_allocated_output |
out_error | output | gln_error_t* | nullable | caller_allocated_output |
Notes
Missing entries are not failures; the call reports GLN_OK and writes zero to out_removed_or_null when that output slot is supplied.
On failure, out_error is populated when provided. Release that populated direct error slot with gln_release_error before reusing it for another call.
See Continuations for the save/load/remove sequence.