BINDSTRUCT

Updated August 2022

.BINDSTRUCT ds, st

Parameters

an instance of a DYNSTRUCT

an instance of a DEFSTRUCT

The .BINDSTRUCT statement binds the specified DYNSTRUCT variable (ds) to the structure definition corresponding to the specified DEFSTRUCT instance variable (st). Then it copies the data from the DEFSTRUCT instance to the DYNSTRUCT.

This would be equivalent to the following...

xcall MIAMEX, MX_DYNSTRUCT, DYNOP_DEF, status, src$, fields, stsize, dsname$

xcall MIAMEX, MX_DYNSTRUCT, DYNOP_BIND, status, dsname$, ds

ds = st

... except that the structure name (dsname$) is determined implicitly from the structure variable instance (st), and the src$ parameter is set to "" to extract the structure definition from the current RUN file directly.

Note that DEFSTRUCTs are embedded in the RUN file only under certain conditions. If not embedded by the compiler, you can embed them at run time using MX_DYNSTRUCT. See the links before for more details.

Also note that the second argument (the defstruct instance) may be a base array reference. For example:

.BINDSTRUCT ds, st()

In this case, the structure is bound to the DYNSTRUCT instance (ds), but no data is copied. However, once bound, you can then manually copy elements from the array, using the same binding, e.g.

.bindstruct ds, st() ! bind w/o copy

for i = .extent(st())

ds = st(i) ! copy, preserving prior binding

? ds,@fldname$ ! dynstruct deferred indirect ref

next i