Daylight v4.9
Release Date: 1 February 2008

Name

dt_thor_indirect_hint - specify the "hint" for indirect data fetching

Generic Prototype

dt_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 Prototype

include 'dt_f_thor.inc'

logical dt_f_thor_indirect_hint(database, hint)

integer*4 database
integer*4 hint

Description

Sets 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 Value

Returns the success (TRUE) or failure (FALSE) of the operation.

Related Topics

dt_thor_tdtget(3) dt_thor_getauxillarydb(3) dt_thor_setauxillarydb(3)