Release Date: 1 February 2008
Namedt_thor_indirect_hint - specify the "hint" for indirect data fetching
Generic Prototypedt_thor_indirect_hint(dt_Handle, dt_Integer) => dt_Boolean
C Prototype#include "dt_thor.h"
dt_Boolean dt_thor_indirect_hint(dt_Handle database, dt_Integer hint)
FORTRAN Prototypeinclude 'dt_f_thor.inc'
logical dt_f_thor_indirect_hint(database, hint)
DescriptionSets the "hint" for the indirect-data-fetching strategy for a database. "hint" indicates:
Each indirect-data expansion happens as the datafield is referenced.DX_THOR_INDIRECT_GETALL
When an indirect-data datafield is referenced, all indirect data for the whole TDT is fetched in a single operation.Both strategies are useful, depending on the situation. For TDTs with only a few indirect datafields, it doesn't matter much which strategy is employed. For TDTs with hundreds or thousands of indirect references, the appropriate strategy depends on how many of the datafields will eventually need expansion. For example Daylight's TDT widget expands all datafields while computing the layout of its display, so it works better with DX_THOR_INDIRECT_GETALL. A program that looked up a single dataitem from a TDT would be more efficient using DX_THOR_INDIRECT_GETONE.
Return ValueReturns the success (TRUE) or failure (FALSE) of the operation.
Related Topicsdt_thor_tdtget(3) dt_thor_getauxillarydb(3) dt_thor_setauxillarydb(3)