GALANTHUS / ABI FUNCTION REFERENCE
gln_get_account_currency
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_account_currency(const gln_account_t* in_account);
Purpose
Returns the account currency.
Return
Returns the account currency text stored on the row. Owned producers usually materialize ISO 4217-style currency codes, but provider plugins can expose other provider strings.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_account | input | const gln_account_t* | nullable | borrowed |
Account Metadata
Returns the account currency text stored on the row. Owned producers usually materialize ISO 4217-style currency codes, but provider plugins can expose other provider strings.
An empty string means the source row did not provide an account currency. Balance and transaction rows expose their own currency fields separately.
Notes
Passing NULL for in_account 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.