GALANTHUS / ABI FUNCTION REFERENCE
gln_get_transaction_remote_name
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_transaction_remote_name(const gln_transaction_t* in_transaction);
Purpose
Returns the remote party name.
Return
Returns the counterparty name stored on the row. For debit rows this is typically the creditor/recipient; for credit rows it is typically the debtor/sender when the parser can derive direction.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_transaction | input | const gln_transaction_t* | nullable | borrowed |
Counterparty Semantics
Returns the counterparty name stored on the row. For debit rows this is typically the creditor/recipient; for credit rows it is typically the debtor/sender when the parser can derive direction.
An empty string means the source row did not provide a usable counterparty name. The pointer itself is non-null for a valid row.
Notes
Passing NULL for in_transaction 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.