debugDDe (1158408), страница 3

typedef struct tag_VarInfo

{

byte

Busy;

void *

VarAddr;

long

PrevNo;

int

EnvirIndex;

byte

Type;

SysHandle *

Handle;

void *

Info;

int

Tag;

byte

IsInit;

PFN_VARTABLE_ELEMDESTRUCTOR

pfnDestructor;

}

VarInfo;

Busy

–

flag is equal 1 if this element contains valid variable information and 0 if variable is removed from the table of variables. This flag is used for work optimization and preventing frequent memory copying.

VarAddr

–

variable address;

PrevNo

–

the number of table of variables element that describes the same variable on a previous level

EnvirIndex

–

number of the variable level

Type

–

the class of variable using

Handle

–

handle of a distributed array. It is not equal to zero if this element describes a distributed array

Info

–

pointer to an additional variable information structure. It is depended on a variable type.

Tag

–

flag to store various variable attributes according to type of variable usage

IsInit

–

flag of variable initialization. Is used for scalar variables.

pfnDestructor

–

pointer to variable description destructor. This function is called when variable is removed from the table of variables. It can be equal NULL

typedef struct tag_VAR_TABLE

{

HASH_TABLE

hIndex;

TABLE

vTable;

}

VAR_TABLE;

hIndex

–

hash-table. It is used for searching variable information by its address.

vTable

–

table used to keep variable information

void vartable_Init( VAR_TABLE *VT, int vTableSize, int hIndexSize, int hTableSize, PFN_CALC_HASH_FUNC Func )

VT

–

pointer to table of variables structure to be initialized

vTableSize

–

size of vTable expanding;

hIndexSize

–

size of hash-index array of hIndex;

hTableSize

–

size of hash-table hIndex expanding;

Func

–

pointer to a function that calculates hash-value by variable address.

void vartable_Done( VAR_TABLE *VT );

VT

–

pointer to table of variables structure

VarInfo *vartable_GetVarInfo( VAR_TABLE *VT, long NoVar )

VT

–

pointer to table of variables structure

NoVar

–

number of variable in the table of variables

VarInfo *vartable_FindVar( VAR_TABLE *VT, void * Addr )

VT

–

pointer to table of variables structure

Addr

–

variable address.

long vartable_FindNoVar( VAR_TABLE *VT, void * Addr )

VT

–

pointer to table of variables structure

Addr

–

variable address.

long vartable_PutVariable(VAR_TABLE* VT, void* Addr, int Env, byte Type, SysHandle* Handle, int Tag, void* Info, PFN_VARTABLE_ELEMDESTRUCTOR pfnDestructor)

VT

–

pointer to table of variables structure

Addr

–

variable address.

Env

–

variable level

Type

–

class of variable usage

Handle

–

distributed array handle if distributed array is registered

Tag

–

variable attributes;

Info

–

pointer to additional variable information;

pfnDestructor

–

pointer to variable information destructor. It can be NULL

void vartable_VariableDone( VarInfo* Var )

Var

–

pointer to variable information structure

void vartable_RemoveVariable( VAR_TABLE *VT, void * Addr )

VT

–

pointer to table of variables structure.

Addr

–

variable address.

void vartable_RemoveAll( VAR_TABLE *VT );

VT

–

pointer to table of variables structure.

void vartable_RemoveVarOnLevel( VAR_TABLE *VT, int Level )

VT

–

pointer to table of variables structure.

Level

–

executed level

void vartable_Iterator( VAR_TABLE *VT, PFN_VARTABLEITERATION Func )

VT

–

pointer to table of variables structure.

Func

–

iteration function with the following prototype:

void (*PFN_VARTABLEITERATION)( VarInfo * ).

All the pointers to variable information structures from the variable table are passed to the function.

void vartable_LevelIterator(VAR_TABLE* VT, int Level, PFN_VARTABLEITERATION Func)

VT

–

pointer to table of variables structure.

Level

–

variable level

Func

–

iteration function with the following prototype:

void (*PFN_VARTABLEITERATION)( VarInfo * ).

All the variable information structures of the table of variables with specified variable level are passed to the function