GALANTHUS / ABI FUNCTION REFERENCE
gln_get_account_subaccount_number
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_account_subaccount_number(const gln_account_t* in_account);
Purpose
Returns the account subaccount number.
Return
Returns the FinTS subaccount number when the row carries one. Use the exact returned text with APIs that need a subaccount value.
| 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 FinTS subaccount number when the row carries one. Use the exact returned text with APIs that need a subaccount value.
An empty string means the source row did not provide a subaccount number. Use the exact returned text when an API needs the subaccount component.
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.