Success SetArrayLong(long id,long idx,long value);

Функция присваивает значение типа «длинное целое» элементу массива, заданного идентификатором.

Индекс массива выражается 32-битным целым числом. Разряженные массивы позволяют эффективно хранить данные, не резервируя памяти под несуществующие элементы.

Поэтому индексы не обязательно должны следовать один за другим. Так, например, массив может состоять всего из двух индексов, – скажем 0х0 и 0х10000, – при этом будет потрачено всего две ячейки памяти.

Необходимо помнить, что один и тот же индекс, одного и того же массива может хранить одновременно данные двух тиров – как строковые, так и длинные целые и никакого «затирания при этом не происходит».

Пример использования:

SetArrayLong(

GetArrayId(“MyArray”),

0x100,

0x666);

Операнд	Пояснения
id	Идентификатор массива
idx	Индекс массива
value	Присваиваемое значение типа «длинное целое»
Return	==return	Пояснения
	==1	Успешное завершение
	==0	Ошибка

Success SetArrayString(long id,long idx,char str);

Функция присваивает значение типа «строка» элементу массива, заданного идентификатором.

Индекс массива выражается 32-битным целым числом. Разряженные массивы позволяют эффективно хранить данные, не резервируя памяти под несуществующие элементы.

Поэтому индексы не обязательно должны следовать один за другим. Так, например, массив может состоять всего из двух индексов, – скажем 0х0 и 0х10000, – при этом будет потрачено всего две ячейки памяти.

Необходимо помнить, что один и тот же индекс, одного и того же массива может хранить одновременно данные двух тиров – как строковые, так и длинные целые и никакого «затирания при этом не происходит».

Пример использования:

SetArrayString(

GetArrayId(“MyArray”),

0x100,

“MyString”);

Операнд	Пояснения
id	Идентификатор массива
idx	Индекс массива
str	Присваиваемое значение типа «строка»
Return	==return	Пояснения
	==1	Успешное завершение
	==0	Ошибка

Char or long GetArrayElement(long tag,long id,long idx);

Функция служит для чтения обоих типов элементов разряженных массивов. Выбор интересующего типа осуществляется тегом tag.

Он может принимать следующие значения:

Определение		Значение
AR_LONG	'A'	Элемент типа «длинное целое»
AR_STR	'S'	Элемент типа «строка»

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

Пример использования:

SetArrayLong(

GetArrayId(“MyArray”),

0x100,

0x666);

SetArrayString(

GetArrayId(“MyArray”),

0x100,

“MyString”);

Message(“%s \n0x%X\n”,

GetArrayElement(AR_STR,

GetArrayId(“MyArray”),

0x100),

GetArrayElement(AR_LONG,

GetArrayId(“MyArray”),

0x100),

);

MYString

0x666

Операнд	Пояснения
tag	==tag	Значение
	AR_STR	Элемент типа «строка»
	AR_LONG	Элемент типа «длинное целое»
id	Идентификатор массива
idx	Индекс массива
Return	==return	Пояснения
	==1	Успешное завершение
	==0	Ошибка