====== Build_Struct function  ======

 


 
==== Description ====
 
Assembles a binary structure out of BASIC+ variables.
 
==== Syntax ====
 
struct = **Build_Struct**(structname, element1 [, … element32])
 
==== Parameters ====
 
Use this function to build a structure to pass to a DLL function. Alternatively, the Var_To_Struct function can be used to convert a dynamic array into a structure as long as none of the elements are char or char array types containing character values greater than @VM (hex FD, decimal 253).

This function is the opposite of the Parse_Struct subroutine.

The structure definition must be pre-defined using the [[define_struct|Define_Struct routine.]]
 

 
==== See Also ====
 
[[blank_struct|Blank_Struct()]], [[define_struct|Define_Struct]], [[parse_struct|Parse_Struct]], [[var_to_struct|Var_To_Struct()]], [[chapter_dll|Chapter 7]]
 
==== Example ====
 
<code>
/* assuming the structure called RECT has been defined as being composed of 4 "signed short" elements, this code builds a rectangle structure based on the location and size of an OpenInsight form. */

declare function Get_Property, Build_Struct
size   = Get_Property(@window, "SIZE")
left   = size<1>
top    = size<2>
right  = size<1> + size<3>
bottom = size<2> + size<4>
rect   = Build_Struct("RECT", left, top, right, bottom)
 
**
**
</code>