GALANTHUS / ABI FUNCTION REFERENCE
gln_get_balance_currency
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_balance_currency(const gln_balance_t* in_balance);
Purpose
Returns the balance currency code.
Return
Returns the currency associated with the balance amount and related balance amount fields. Read it together with gln_get_balance_amount; currency is exposed through this accessor when materialized separately.
| 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 currency associated with the balance amount and related balance amount fields. Read it together with gln_get_balance_amount; currency is exposed through this accessor when materialized separately.
Owned producers usually materialize ISO 4217-style currency codes. Treat the value as an open provider string.
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.