Skip to content

GALANTHUS / ABI FUNCTION REFERENCE

gln_get_backend_result_bank_info

Declared in <galanthus/c_api/gln_capi.h>.

GLN_API const gln_bank_info_t* GLN_CALL gln_get_backend_result_bank_info(
    const gln_backend_result_t* in_result);
  • Family: Backend result accessors
  • Return type: const gln_bank_info_t*

Purpose

Borrows the typed info result view from a backend result envelope whose kind is GLN_BACKEND_RESULT_KIND_BANK_INFO.

The accessor returns NULL when the envelope carries a different result kind.

Return

Returns the borrowed const gln_bank_info_t* view only when gln_get_backend_result_kind reports GLN_BACKEND_RESULT_KIND_BANK_INFO.

TypeNullabilityOwnership
const gln_bank_info_t*nullableborrowed

Parameters

NameDirectionTypeNullabilityOwnership
in_resultinputconst gln_backend_result_t*nullableborrowed

Projection Semantics

Returns the borrowed const gln_bank_info_t* view only when gln_get_backend_result_kind reports GLN_BACKEND_RESULT_KIND_BANK_INFO.

The accessor checks the envelope kind directly; it does not check gln_get_backend_result_outcome or gln_get_backend_result_status. Callers should inspect outcome, status, and kind before projecting a typed success payload.

NULL means either in_result is NULL or the envelope kind does not match this projection.

The returned view is borrowed from the envelope. Destroying the envelope invalidates the view, rows or nested handles borrowed from it, and strings returned by field accessors.

Notes

Passing NULL for in_result is allowed and returns NULL.

Call this only after gln_get_backend_result_outcome reports GLN_BACKEND_OUTCOME_SUCCESS and gln_get_backend_result_kind reports GLN_BACKEND_RESULT_KIND_BANK_INFO.

The returned info view is borrowed from the envelope. Destroying the envelope invalidates the view, its scalar strings, embedded account rows, and supported-version strings.

See Also