gln_get_transactions_next_page_token

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

GLN_API const char* GLN_CALL gln_get_transactions_next_page_token(const gln_transactions_t* in_transactions);

• Family: Typed transaction list accessors
• Return type: const char*

Purpose

Returns the next-page token from a typed transaction list when the backend result advertised another page.

Return

Returns the opaque continuation token for the next transaction page when the backend advertised one. Pass it as a later list-transactions page token for the same backend/account flow. Returns NULL when the optional field is not materialized or when the input handle is NULL.

Parameters

Pagination

Returns the opaque continuation token for the next transaction page when the backend advertised one. Pass it as a later list-transactions page token for the same backend/account flow.

The returned string is borrowed from the transaction view. Copy it before destroying the backend result envelope if it will be used after that result is released.

Notes

Passing NULL for in_transactions is allowed and returns NULL.

NULL means the backend did not advertise another page for this transaction result.

Treat a non-null token as opaque. Copy it before destroying the result envelope if it will be passed to a later gln_retrieve_transactions call.

The returned pointer is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.

See Also

• gln_retrieve_transactions
• gln_get_backend_result_transactions
• gln_get_transactions_count
• gln_get_transaction_at
• ABI function index