GALANTHUS / ABI FUNCTION REFERENCE
gln_get_standing_order_currency
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_standing_order_currency(const gln_standing_order_t* in_standing_order);
Purpose
Returns the standing-order currency code.
Return
Returns the currency associated with the standing-order amount. Read it together with gln_get_standing_order_amount; currency is exposed through this accessor when materialized separately.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_standing_order | input | const gln_standing_order_t* | nullable | borrowed |
Amount And Purpose
Returns the currency associated with the standing-order amount. Read it together with gln_get_standing_order_amount; currency is exposed through this accessor when materialized separately.
Treat the value as an open provider string. For a valid row the returned pointer is non-null; an empty string means no currency was materialized for the row.
Notes
Passing NULL for in_standing_order 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.