Description

Extracts elements from a structure into BASIC+ variables.

Syntax

Parse_Struct(struct, structname, element1 [, … element32])

Remarks

Use this function to parse a structure returned by a DLL function. Alternatively, the Struct_To_Var function can be used to convert a structure into a dynamic array 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 Build_Struct function.

The structure definition must be predefined using the Define_Struct routine.

See also

Build_Struct(), Struct_To_Var(), Var_To_Struct()

Example

/* assumes the structure called RECT has been defined as being composed of 4 "signed short" elements and the API function GetWindowRect has been defined in DLL_USER as:  
VOID PASCAL GetWindowRect(USHORT, LPCHAR) */

declare function Get_Property, Blank_Struct, GetWindowsRect
declare subroutine Parse_Struct

hwnd = Get_Property(@window, "HANDLE")
rect = Blank_Struct("RECT")
GetWindowsRect(hwnd, rect)
Parse_Struct(rect, "RECT", left, top, right, bottom)