GALANTHUS / ABI FUNCTION REFERENCE
gln_get_holding_price_currency
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_holding_price_currency(const gln_holding_t* in_holding);
Purpose
Returns the price currency when available.
Return
Returns the currency associated with the price. Read it together with gln_get_holding_price; currency is exposed through this accessor when materialized separately. Returns NULL when the optional field is not materialized or when the input handle is NULL.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_holding | input | const gln_holding_t* | nullable | borrowed |
Price Semantics
Returns the currency associated with the price. Read it together with gln_get_holding_price; currency is exposed through this accessor when materialized separately.
Treat the value as an open provider string. NULL means the materialized holding row has no price-currency field.
Notes
Passing NULL for in_holding is allowed and returns NULL.
NULL means the provider did not supply this optional field for the row.
The returned pointer is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.