GALANTHUS / ABI FUNCTION REFERENCE
gln_get_balance_amount
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_balance_amount(const gln_balance_t* in_balance);
Purpose
Returns the booked balance amount as a decimal string.
Return
Returns the booked balance amount as a borrowed decimal string. The currency is exposed separately by gln_get_balance_currency.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_balance | input | const gln_balance_t* | nullable | borrowed |
Amount Semantics
Returns the booked balance amount as a borrowed decimal string. The currency is exposed separately by gln_get_balance_currency.
FinTS and CAMT parsing paths mark debit balances with a leading - when the source supplies debit/credit direction. Plugin rows expose the amount string produced by their mapping.
Notes
Passing NULL for in_balance is allowed and returns NULL.
Rows returned by the matching _at accessor carry this field as part of the materialized typed result.
The returned pointer is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.