GALANTHUS / ABI FUNCTION REFERENCE
gln_set_direct_debit_batch_request_item_capacity
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API gln_status_t GLN_CALL gln_set_direct_debit_batch_request_item_capacity(
gln_direct_debit_batch_request_builder_t* in_builder,
size_t in_item_capacity,
gln_error_t* out_error_or_null);
Purpose
Reserves storage for in_item_capacity items in the caller-owned gln_direct_debit_batch_request_builder_t so subsequent adds do not need to grow the internal buffer.
Calling this is a hint, not a hard limit: the builder still grows on demand if more items are added than reserved.
Nullable parameter slots (out_error_or_null) 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_builder | input | gln_direct_debit_batch_request_builder_t* | nonnull | borrowed |
in_item_capacity | input | size_t | value | value |
out_error_or_null | output | gln_error_t* | nullable | caller_allocated_output |