debugDDr (1158410), страница 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

–

флаг, указывающий свободна эта структура или нет. Служит для оптимизации операций с таблицей переменных;

VarAddr

–

адрес переменной;

PrevNo

–

номер элемента таблицы переменных, описывающий ту же переменную в другом контексте выполнения;

EnvirIndex

–

номер уровня исполнения программы для данной переменной;

Type

–

класс переменной;

Handle

–

указатель на дескриптор распределенного массива. Неравен NULL, если структура описывает распределенный массив;

Info

–

указатель на дополнительное описание переменной;

Tag

–

флаг для хранения различных атрибутов переменной в зависимости от класса ее использования;

IsInit

–

флаг инициализации переменной. Используется для скалярных переменных;

pfnDestructor

–

указатель на деструктор описания переменной. Данная функция будет вызвана при удалении описания переменной из таблицы переменных. Может быть равен NULL.

typedef struct tag_VAR_TABLE

{

HASH_TABLE

hIndex;

TABLE

vTable;

}

VAR_TABLE;

hIndex

–

хеш-таблица для поиска информации о переменной по ее адресу;

vTable

–

таблица для хранения описаний переменных.

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

VT

–

указатель на таблицу переменных;

vTableSize

–

размер приращения таблицы vTable;

hIndexSize

–

размер массива индексов хеш-таблицы hIndex;

hTableSize

–

размер приращения хеш-таблицы hIndex;

Func

–

указатель на функцию, используемую для вычисления хеш-значения по адресу переменной.

void vartable_Done( VAR_TABLE *VT );

VT

–

указатель на таблицу переменных

VarInfo *vartable_GetVarInfo( VAR_TABLE *VT, long NoVar )

VT

–

указатель на таблицу переменных;

NoVar

–

номер переменной в таблице.

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

VT

–

указатель на таблицу переменных;

Addr

–

адрес переменной.

long vartable_FindNoVar( VAR_TABLE *VT, void * Addr )

VT

–

указатель на таблицу переменных;

Addr

–

адрес переменной.

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

VT

–

указатель на таблицу переменных;

Addr

–

адрес переменной;

Env

–

номер уровня выполнения;

Type

–

тип использования переменной;

Handle

–

дескриптор распределенного массива при его регистрации;

Tag

–

значение дополнительного атрибута переменной;

Info

–

указатель на дополнительную информацию;

pfnDestructor

–

указатель на деструктор описания переменной. Может быть равен NULL.

void vartable_VariableDone( VarInfo* Var )

Var

–

указатель на описание переменной.

void vartable_RemoveVariable( VAR_TABLE *VT, void * Addr )

VT

–

указатель на таблицу переменных;

Addr

–

адрес удаляемой переменной.

void vartable_RemoveAll( VAR_TABLE *VT );

VT

–

указатель на таблицу переменных.

void vartable_RemoveVarOnLevel( VAR_TABLE *VT, int Level )

VT

–

указатель на таблицу переменных

Level

–

номер уровня выполнения

void vartable_Iterator( VAR_TABLE *VT, PFN_VARTABLEITERATION Func )

VT

–

указатель на таблицу переменных;

Func

–

итерационная функция с прототипом:

void (*PFN_VARTABLEITERATION)(VarInfo *).

Функции будут переданы все указатели на описания переменных в таблице переменных.

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

VT

–

указатель на таблицу переменных;

Level

–

номер уровня выполнения;

Func

–

итерационная функция с прототипом:

void (*PFN_VARTABLEITERATION)(VarInfo *).

Функции будут по очереди переданы все указатели на описания переменных в таблице переменных, имеющих указанный номер контекста выполнения.