Daylight v4.9 Release Date: 1 February 2008 Namedt_thor_indirect_hint - specify the "hint" for indirect data fetchingGeneric Prototypedt_thor_indirect_hint(dt_Handle, dt_Integer) => dt_BooleanC 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)
integer*4 database
DescriptionSets the "hint" for the indirect-data-fetching strategy for a database. "hint" indicates:DX_THOR_INDIRECT_GETONE 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) |