GALANTHUS / ABI FUNCTION REFERENCE
gln_get_account_iban
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_account_iban(const gln_account_t* in_account);
Purpose
Returns the account IBAN.
Return
Returns the account IBAN stored on the row. Use it as the account selector for balance, transaction, and standing-order read requests when the backend requires an IBAN.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_account | input | const gln_account_t* | nullable | borrowed |
Account Identity
Returns the account IBAN stored on the row. Use it as the account selector for balance, transaction, and standing-order read requests when the backend requires an IBAN.
An empty string means the source row did not provide an IBAN. The pointer itself is non-null for a valid row.
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.