Admin: 1 revision imported

2021-02-07T06:51:49Z

1 revision imported

Admin at 16:18, 8 June 2020

2020-06-08T16:18:25Z

New page

{{infobox function
|name=SystemAddress
|object=[[Буфер#Объект структуры данных записи|Запись]]
|caption=Информация по записи
|type=1
|status=2
|db=0
|exception=Невозможно превратить в число, строку, неверный индекс, неверное имя поля.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Буфер]]}}
Функция возвращает системный указатель на указанное имя поля (для полей-массивов также можно указать индекс массива). Запись должна быть привязана. В отличие от функции [[MemoryRecord.Index|Index]], указатель может быть получен для вложенных записей без какого-либо дополнительного вычисления. '''Внимание''': использование системных указателей опасно, запись или чтение может вызвать системное исключение доступа, если адрес недоступен или память не выделена.

== Синтаксис ==
<code>
{{Grey|MemoryRecord.}}'''SystemAddress'''({{Optional|<Наименование поля (STRING)>,<Индекс массива (INT)>{{Default|{{Eq}}0}}}}):''<Системный адрес к данным поля (INT)>''
</code>
==== Аргументы ====
* <code>''<Наименование поля (STRING)>''</code> - {{Optional}} Задает наименование поля записи, системный адрес для которого необходимо найти. Наименование задается без учета регистра. Если наименование не задано, функция возвращает смещение на начало записи (первое поле записи).
* <code>''<Индекс массива (INT)>''</code> - {{Optional}} Если поле является массивом, аргумент может указывать на индекс массива, смешения для которого необходимо найти. Первый элемент массива имеет индекс 0. По умолчанию, смешение будет найдено для первого элемента массива.

==== Возвращаемое значение ====
Возвращается числовое значение.

== Примеры ==
<pre>
//Заполнение буфера
aBuf:=Buffer.Create(4096);
aBuf.Fill(0,4096,0);
//Байт с позицией 3 равен 132.
aBuf[3]:=132;
//Адрес буфера в системной памяти
aMem:=aBuf.SystemAddress();

//Создание записи
rRec:=MemoryRecord.Create("Value:A6:UI8");
//Создание второй записи с ссылкой на первую
rRec2:=MemoryRecord.Create("V1:UI32,Value:^@rRec");
//Выделение памяти под запись
bBuf:=rRec2.Allocate();
//Запись адреса памяти в начало записи (работает как для x86, так и для x64)
If PointerSize()=4 Then
bBuf.SetDWord(4,aMem);
Else
bBuf.SetQWord(4,aMem);
EndIf;

//Системный указатель на элемент массива rRec2.Value.Value[3]
aMem:=rRec2.Value.SystemAddress("Value",3);
rRec3:=MemoryRecord.Create("data:UI8");
rRec3.AssignToSystemMemory(aMem);

//Будет выведено число 132
Message(rRec3.data);
</pre>

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)

MemoryRecord.SystemAddress - Revision history

Admin: 1 revision imported

Admin at 16:18, 8 June 2020