Буфер - Revision history

Admin: 1 revision imported

2025-01-22T06:57:21Z

1 revision imported

1>Admin: /* Атрибуты и функции */

2025-01-20T09:18:22Z

‎Атрибуты и функции

Admin: 1 revision imported

2023-06-08T10:14:42Z

1 revision imported

1>Admin: /* Объект структуры данных записи */

2023-05-09T17:19:30Z

‎Объект структуры данных записи

Admin: 1 revision imported

2022-03-13T10:11:10Z

1 revision imported

1>Admin at 18:02, 18 February 2022

2022-02-18T18:02:55Z

Admin: 1 revision imported

2021-02-07T06:54:56Z

1 revision imported

Admin: /* Объект структуры данных записи */

2020-06-08T16:18:07Z

‎Объект структуры данных записи

New page

{{infobox object
|object=Buffer
|status=2
|create=[[Buffer.Create|Create]]}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]}}

Объект '''буфер''' используется как хранилище любой бинарной информации. В буфер, к примеру, можно загрузить внешний файл в бинарном формате и разобрать этот формат программно. Объект позволяет чтение и запись данных типа байты (8 бит), слова (16 бит), двойные слова (32 бита), учетверенные слова (64 бит), строки. При записи в буфер, он будет автоматически увеличиваться до нужного размера. Размер буфера всегда измеряется в байтах. Индекс буфера при записи или чтении из него начинается с нуля и также измеряется в количестве байт с начала буфера.

== Атрибуты и функции==
{{function header}}
{{function entry
|name=[[Buffer.Array|[<Индекс буфера (INT)>], [<Индекс буфера (INT)>,<Размер данных (INT)>]]]
|form={{Grey|Buffer}}'''[<Индекс буфера (INT)>{{Optional|,<Размер данных (INT)>{{Default|{{Eq}}1}}}}]''':''<Данные буфера (INT)>''
|type=0
|status=2
|visual=0
|description=Использование синтаксиса массивов позволяет получить или изменить содержимое буфера по его индексу. Размер данных можно задать вторым аргументом массива.
}}
{{function entry
|name=[[Buffer.Create|Create]]
|form={{Grey|Buffer.}}'''Create'''({{Optional|<Исходный размер буфера (INT)>{{Default|{{Eq}}0}}}}):''<Новый объект (BUFFER)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает новый объект типа [[Буфер]] с нужным начальным размером, если необходимо.
}}
{{function entry
|name=[[Buffer.Size|Size]]
|form={{Grey|Buffer.}}'''Size'''({{Optional|<Новый размер буфера (INT)>}}):''<Текущий размер буфера (INT)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает текущий размер буфера, также изменяет этот размер, если задан первый аргумент.
}}
{{function entry
|name=[[Buffer.LoadFromFile|LoadFromFile]]
|form={{Grey|Buffer.}}'''LoadFromFile'''(''<Путь и имя файла (STRING)>''{{Optional|,<Начальная позиция файла (INT)>{{Default|{{Eq}}0}},<Количество байтов для чтения (INT)>,<Индекс буфера (INT)>{{Default|{{Eq}}0}}}})
|type=1
|status=2
|visual=0
|description=Функция читает требуемую часть указанного файла в буфер, начиная с указанного индекса. Если в процессе чтения произошла ошибка, функция вызывает исключение.
}}
{{function entry
|name=[[Buffer.SaveToFile|SaveToFile]]
|form={{Grey|Buffer.}}'''SaveToFile'''(''<Путь и имя файла (STRING)>''{{Optional|,<Индекс буфера (INT)>{{Default|{{Eq}}0}},<Количество байтов для записи (INT)>}})
|type=1
|status=2
|visual=0
|description=Функция сохраняет требуемую часть буфера в указанный файл. Если в процессе чтения произошла ошибка, функция вызывает исключение.
}}
{{function entry
|name=[[Buffer.AppendToFile|AppendToFile]]
|form={{Grey|Buffer.}}'''AppendToFile'''(''<Путь и имя файла (STRING)>''{{Optional|,<Индекс буфера (INT)>{{Default|{{Eq}}0}},<Количество байтов для записи (INT)>}})
|type=1
|status=2
|visual=0
|description=Функция добавляет требуемую часть буфера к содержимому указанного файла. Если в процессе чтения произошла ошибка, функция вызывает исключение.
}}
{{function entry
|name=[[Buffer.GetByte|GetByte]]
|form={{Grey|Buffer.}}'''GetByte'''(''<Индекс буфера (INT)>''{{Optional|,''<Число со знаком (INT)>''{{Default|{{Eq}}0}}}}):''<Значение (INT)>''
|type=1
|status=2
|visual=0
|description=Функция получает байт (со знаком, если необходимо) из буфера по указанному индексу
}}
{{function entry
|name=[[Buffer.GetWord|GetWord]]
|form={{Grey|Buffer.}}'''GetWord'''(''<Индекс буфера (INT)>''{{Optional|,''<Число со знаком (INT)>''{{Default|{{Eq}}0}}}}):''<Значение (INT)>''
|type=1
|status=2
|visual=0
|description=Функция получает слово (со знаком, если необходимо) из буфера по указанному индексу
}}
{{function entry
|name=[[Buffer.GetDWord|GetDWord]]
|form={{Grey|Buffer.}}'''GetDWord'''(''<Индекс буфера (INT)>''{{Optional|,''<Число со знаком (INT)>''{{Default|{{Eq}}0}}}}):''<Значение (INT)>''
|type=1
|status=2
|visual=0
|description=Функция получает двойное слово (со знаком, если необходимо) из буфера по указанному индексу
}}
{{function entry
|name=[[Buffer.GetQWord|GetQWord]]
|form={{Grey|Buffer.}}'''GetQWord'''(''<Индекс буфера (INT)>''):''<Значение (INT)>''
|type=1
|status=2
|visual=0
|description=Функция получает 64-битное целое число (число всегда будет иметь знак) из буфера по указанному индексу
}}
{{function entry
|name=[[Buffer.GetRealNumber|GetRealNumber]]
|form={{Grey|Buffer.}}'''GetRealNumber'''(''<Индекс буфера (INT)>''{{Optional|,<Тип числа (INT)>{{Default|{{Eq}}0}}}}):''<Значение (REAL)>''
|type=1
|status=2
|visual=0
|description=Функция получает вещественное число из буфера по указанному индексу.
}}
{{function entry
|name=[[Buffer.SetByte|SetByte]]
|form={{Grey|Buffer.}}'''SetByte'''(''<Индекс буфера (INT)>'',''<Значение (INT)>'')
|type=1
|status=2
|visual=0
|description=Функция сохраняет байт (со знаком или без) в буфер по указанному индексу
}}
{{function entry
|name=[[Buffer.SetWord|SetWord]]
|form={{Grey|Buffer.}}'''SetWord'''(''<Индекс буфера (INT)>'',''<Значение (INT)>'')
|type=1
|status=2
|visual=0
|description=Функция сохраняет слово (со знаком или без) в буфер по указанному индексу
}}
{{function entry
|name=[[Buffer.SetDWord|SetDWord]]
|form={{Grey|Buffer.}}'''SetDWord'''(''<Индекс буфера (INT)>'',''<Значение (INT)>'')
|type=1
|status=2
|visual=0
|description=Функция сохраняет двойное слово (со знаком или без) в буфер по указанному индексу
}}
{{function entry
|name=[[Buffer.SetQWord|SetQWord]]
|form={{Grey|Buffer.}}'''SetQWord'''(''<Индекс буфера (INT)>'',''<Значение (INT)>'')
|type=1
|status=2
|visual=0
|description=Функция сохраняет 64-битное числовое значение в буфер по указанному индексу
}}
{{function entry
|name=[[Buffer.SetRealNumber|SetRealNumber]]
|form={{Grey|Buffer.}}'''SetRealNumber'''(''<Индекс буфера (INT)>'',''<Значение (REAL)>''{{Optional|,<Тип числа (INT)>{{Default|{{Eq}}0}}}})
|type=1
|status=2
|visual=0
|description=Функция сохраняет вещественное числовое значение в буфер по указанному индексу.
}}
{{function entry
|name=[[Buffer.GetString|GetString]]
|form={{Grey|Buffer.}}'''GetString'''(''<Индекс буфера (INT)>'',''<Размер строки в байтах (INT)>''{{Optional|,''<Кодовая страница (INT)>''{{Default|{{Eq}}0}}}}):''<Результирующая строка (STRING)>''
|type=1
|status=2
|visual=0
|description=Функция получает однобайтовую строку в указанной кодировке возвращает ее в виде ANSI строки, если кодовая страница кодировки равна нулю, или в виде UFT-16 строки, если кодовая страница не равна нулю.
}}
{{function entry
|name=[[Buffer.SetString|SetString]]
|form={{Grey|Buffer.}}'''SetString'''(''<Индекс буфера (INT)>'',''<Строка для записи в буфер (STRING)>''{{Optional|,''<Кодовая страница (INT)>''{{Default|{{Eq}}0}}}})
|type=1
|status=2
|visual=0
|description=Функция записывает в буфер символы из строки, предварительно перекодировав ее в требуемую кодировку. Будет произведена запись однобайтной строки.
}}
{{function entry
|name=[[Buffer.GetStringW|GetStringW]]
|form={{Grey|Buffer.}}'''GetStringW'''(''<Индекс буфера (INT)>'',''<Размер строки в символах (INT)>):''<Результирующая строка (STRING)>''
|type=1
|status=2
|visual=0
|description=Функция получает UTF-16 (двухбайтную) строку из буфера по указанному индексу.
}}
{{function entry
|name=[[Buffer.SetStringW|SetStringW]]
|form={{Grey|Buffer.}}'''SetStringW'''(''<Индекс буфера (INT)>'',''<Строка для записи в буфер (STRING)>'')
|type=1
|status=2
|visual=0
|description=Функция записывает в буфер символы из UTF-16 (двухбайтной) строки по указанному индексу.
}}
{{function entry
|name=[[Buffer.GetBuffer|GetBuffer]]
|form={{Grey|Buffer.}}'''GetBuffer'''(''<Индекс буфера (INT)>'',''<Размер в байтах (INT)>''):''<Результат-буфер (BUFFER)>''
|type=1
|status=2
|visual=0
|description=Функция создает новый объект буфера и заполняет его указанной частью текущего буфера.
}}
{{function entry
|name=[[Buffer.CopyTo|CopyTo]]
|form={{Grey|Buffer.}}'''CopyTo'''(''<Буфер для записи (BUFFER)>'',''<Индекс текущего буфера для чтения (INT)>'',''<Количество байт для чтения (INT)>''{{Optional|,<Индекс в указанном буфере для записи (INT)>{{Default|{{Eq}}0}}}})
|type=1
|status=2
|visual=0
|description=Функция сохраняет другой буфер по указанному адресу требуемую часть из текущего буфера.
}}
{{function entry
|name=[[Buffer.Fill|Fill]]
|form={{Grey|Buffer.}}'''Fill'''(''<Индекс буфера (INT)>'',''<Размер в байтах (INT)>'',''<Значение для записи (INT)>''{{Optional|,<Тип значения (INT)>{{Default|{{Eq}}0}}}})
|type=1
|status=1
|visual=0
|description=Функция заполняет указанную часть буфера указанным значением. Значение может быть как байтом, словом, двойным словом, так и четверным словом.
}}
{{function entry
|name=[[Buffer.CopyData|CopyData]]
|form={{Grey|Buffer.}}'''CopyData'''(''<Индекс начала данных (INT)>'',''<Размер области в байтах (INT)>'',''<Индекс назначения копирования (INT)>'')
|type=1
|status=2
|visual=0
|description=Функция копирует данные внутри буфера. Данные копируются начиная с начала отрезка, заканчивая концом отрезка копирования (в прямом направлении). Обычно эта процедура применяется при перемещении данных ближе к началу буфера, при этом, отрезок копирования может пересекаться с отрезком назначения.
}}
{{function entry
|name=[[Buffer.CopyDataInverse|CopyDataInverse]]
|form={{Grey|Buffer.}}'''CopyDataInverse'''(''<Индекс начала данных (INT)>'',''<Размер области в байтах (INT)>'',''<Индекс назначения копирования (INT)>'')
|type=1
|status=2
|visual=0
|description=Функция копирует данные внутри буфера. Данные копируются начиная с конца отрезка, заканчивая началом отрезка копирования (в обратном направлении). Обычно эта процедура применяется при перемещении данных дальше к концу буфера, при этом, отрезок копирования может пересекаться с отрезком назначения.
}}
{{function entry
|name=[[Buffer.CopyFromSystemMemory|CopyFromSystemMemory]]
|form={{Grey|Buffer.}}'''CopyFromSystemMemory'''(''<Указатель в системной памяти (INT)>'',''<Размер данных в байтах (INT)>''{{Optional|,<Индекс назначения копирования (INT)>}})
|type=1
|status=2
|visual=0
|description=Функция копирует данные указанного размера из системной памяти в буфер по указанному индексу. '''Внимание''': функция работает с прямыми адресами системной памяти, что может вызвать системное исключение доступа, если адрес недоступен или память не выделена. Системное исключение будет превращено в локальное исключение вызываемое функцией. Функция может использоваться в совокупности с функциями [[Объект загружаемой системной библиотеки|объекта загружаемой системной библиотеки]].
}}
{{function entry
|name=[[Buffer.CopyToSystemMemory|CopyToSystemMemory]]
|form={{Grey|Buffer.}}'''CopyToSystemMemory'''(''<Указатель в системной памяти (INT)>''{{Optional|,<Размер данных в байтах (INT)>,<Индекс в буфере для копирования (INT)>}})
|type=1
|status=2
|visual=0
|description=Функция копирует данные из буфера начиная с указанного индекса заданного размера (или до конца буфера) в системную память. '''Внимание''': функция работает с прямыми адресами системной памяти, что может вызвать системное исключение доступа, если адрес недоступен или память не выделена. Системное исключение будет превращено в локальное исключение вызываемое функцией. Подобное копирование может вызвать порчу данных в памяти без создания системного исключения, которое может привести к непредсказуемым последствиям, начиная от внезапного завершения работы клиента, до общесистемного сбоя. Поэтому прежде чем копировать что-то в системную память, необходимо корректно ее выделить. Функция может использоваться в совокупности с функциями [[Объект загружаемой системной библиотеки|объекта загружаемой системной библиотеки]].
}}
{{function entry
|name=[[Buffer.SystemAddress|SystemAddress]]
|form={{Grey|Buffer.}}'''SystemAddress'''({{Optional|<Индекс в буфере (INT)>{{Default|{{Eq}}0}}}}):''<Указатель в системной памяти (INT)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает указатель в системной памяти на индексом смещения в буфере. '''Внимание''': при записи информации в буфер, его размер автоматически увеличивается, при этом данные буфера могут перемещаться в памяти, и возвращенный ранее указатель будет указывать на адрес в памяти более не принадлежащий буферу. При записи по этому адресу, данные в памяти будут испорчены, что приведет к непредсказуемым последствиям, начиная от внезапного завершения работы клиента, до общесистемного сбоя. Возвращенный указатель можно использовать только до изменения размеров буфера, после чего необходимо сновать вызвать функцию для получения обновленного указателя. Функция может использоваться в совокупности с функциями [[Объект загружаемой системной библиотеки|объекта загружаемой системной библиотеки]].
}}
{{function footer}}

== Объект структуры данных записи ==
Структура данных ''запись'' ('''MemoryRecord''') позволяет получить удобный доступ к бинарным данным в системной памяти или в буфере. Она может использоваться в двух основных случаях:
* Импорт или экспорт бинарных данных (к примеру, чтение формата ''BMP'' или ''WAV'' напрямую с диска)
* Работа с [[Объект загружаемой системной библиотеки|функциями загружаемых системных библиотек]]. Функции часто работают со структурами данных, которые требуется разбирать или создавать для вызова функций библиотек.
Объект позволяет создать запись любой сложности, однако существуют несущественные ограничения, которые можно легко обойти (в данный момент нельзя создать "массив массивов", требуется разделить массивы по разным записям и использовать одну запись внутри другой). Сама запись представляет структуру, не привязанную к памяти, поэтому после создания ее необходимо либо привязать к буферу ([[MemoryRecord.Assign|Assign]] или [[MemoryRecord.Allocate|Allocate]]), либо непосредственно к адресу системной памяти ([[MemoryRecord.AssignToSystemMemory|AssignToSystemMemory]]), после чего поля записи становятся доступными для чтения или записи. Дублирования записи осуществляется с помощью функции [[MemoryRecord.Copy|Copy]], при этом сама структура в памяти не дублируется, создается новая привязка к ней, поэтому, такой процесс происходит быстро и не затрачивает дополнительную память.

Для большей информации и примеров см. статью [[MemoryRecord.Create|Create]].

{{function header}}
{{function entry
|name=[[MemoryRecord.Array|<Имя поля>[<Индекс массива (INT)>]]]
|form={{Grey|MemoryRecord.}}'''<Имя поля>[<Индекс массива (INT)>]''':''<Данные массива>''
|type=0
|status=2
|visual=0
|description=Использование синтаксиса массивов позволяет получить или изменить данные в массивах структуры записей. Запись должна быть привязана к памяти или буферу.
}}
{{function entry
|name=[[MemoryRecord.FieldName|<Имя поля>]]
|form={{Grey|MemoryRecord.}}'''<Имя поля>''':''<Данные поля>''
|type=0
|status=2
|visual=0
|description=Атрибут позволяет получить или изменить данные по имени поля записи. Запись должна быть привязана к памяти или буферу.
}}
{{function entry
|name=[[MemoryRecord.Create|Create]]
|form={{Grey|MemoryRecord.}}'''Create'''(''<Описание структуры записи (STRING)>''{{Optional|,<Привязать созданную запись к буферу (BUFFER)>,<Индекс в буфере (INT)>}}):''<Новый объект записи (MEMORYRECORD)>''
|type=1
|status=2
|visual=0
|description=Функция создает новый объект записи по указанным правилам, привязывая его к существующему буферу, если это необходимо.
}}
{{function entry
|name=[[MemoryRecord.Allocate|Allocate]]
|form={{Grey|MemoryRecord.}}'''Allocate'''():''<Новый буфер записи (BUFFER)>''
|type=1
|status=2
|visual=0
|description=Функция отвязывает запись от ее текущей привязки, создает новый буфер с размером, совпадающим с размером записи и привязывает запись к новому буферу. Созданный буфер будет заполнен нулевыми байтами.
}}
{{function entry
|name=[[MemoryRecord.Buffer|Buffer]]
|form={{Grey|MemoryRecord.}}'''Buffer'''():''<Привязанный буфер или системный указатель (BUFFER,INT)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает объект буфера, привязанного к текущей записи, либо системный указатель, если запись привязана к системной памяти. Если запись не привязана, функция возвращает пустое значение.
}}
{{function entry
|name=[[MemoryRecord.Assign|Assign]]
|form={{Grey|MemoryRecord.}}'''Assign'''(''<Буфер для привязки (BUFFER)>''{{Optional|,<Индекс в буфере (INT)>}})
|type=1
|status=2
|visual=0
|description=Функция отвязывает запись от текущей привязки, и привязывает ее к заданному в аргументе буферу.
}}
{{function entry
|name=[[MemoryRecord.AssignToSystemMemory|AssignToSystemMemory]]
|form={{Grey|MemoryRecord.}}'''AssignToSystemMemory'''(''<Системный указатель (INT)>'')
|type=1
|status=2
|visual=0
|description=Функция отвязывает запись от текущей привязки, и привязывает ее к заданному в аргументе системному указателю. '''Внимание''': запись, привязанная к системной памяти, работает с прямыми адресами системной памяти, что может вызвать системное исключение доступа, если адрес недоступен или память не выделена.
}}
{{function entry
|name=[[MemoryRecord.Copy|Copy]]
|form={{Grey|MemoryRecord.}}'''Copy'''():''<Новый объект записи (MEMORYRECORD)>''
|type=1
|status=2
|visual=0
|description=Функция создает копию структуры записи, и возвращает ее как новую запись. Новая запись не будет привязана.
}}
{{function entry
|name=[[MemoryRecord.Size|Size]]
|form={{Grey|MemoryRecord.}}'''Size'''():''<Размер записи в байтах (INT)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает размер записи в байтах. Запись может быть не привязана.
}}
{{function entry
|name=[[MemoryRecord.Index|Index]]
|form={{Grey|MemoryRecord.}}'''Index'''(''<Наименование поля (STRING)>''{{Optional|,<Индекс массива (INT)>{{Default|{{Eq}}0}}}}):''<Смещение к данным поля от начала записи в байтах (INT)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает смещение указанного поля в байтах от начала записи (для полей-массивов также можно указать индекс массива). Запись может быть не привязана. Важно понимать, что для записей, входящих в другие записи, будет возвращено смещение от начала текущей записи, а не ее родителя.
}}
{{function entry
|name=[[MemoryRecord.SystemAddress|SystemAddress]]
|form={{Grey|MemoryRecord.}}'''SystemAddress'''({{Optional|<Наименование поля (STRING)>,<Индекс массива (INT)>{{Default|{{Eq}}0}}}}):''<Системный адрес к данным поля (INT)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает системный указатель на указанное имя поля (для полей-массивов также можно указать индекс массива). Запись должна быть привязана. '''Внимание''': использование системных указателей опасно, запись или чтение может вызвать системное исключение доступа, если адрес недоступен или память не выделена.
}}
{{function footer}}

{{Объекты}}

← Older revision	Revision as of 06:57, 22 January 2025
(No difference)

@@ Line 14: / Line 14: @@
 {{function entry
 |name=[[Buffer.Array|[<Индекс буфера (INT)>], [<Индекс буфера (INT)>,<Размер данных (INT)>]]]
-|form={{Grey|Buffer}}'''[<Индекс буфера (INT)>{{Optional|,<Размер данных (INT)>{{Default|{{Eq}}1}}}}]''':''<Данные буфера (INT)>''
+|form={{Grey|Buffer}}'''[<Индекс буфера (INT)>{{Optional|,<Размер данных (INT)>{{Default|{{Eq}}1}}}}]''':''<Данные буфера (NUMBER)>''
 |type=0
 |status=2
 |visual=0
-|description=Использование синтаксиса массивов позволяет получить или изменить содержимое буфера по его индексу. Размер данных можно задать вторым аргументом массива.
+|description=Использование синтаксиса массивов позволяет получить или изменить содержимое буфера по его индексу. Размер данных можно задать вторым аргументом массива. Также данные могут быть вещественными числами.
 }}
 {{function entry
@@ Line 171: / Line 171: @@
 |visual=0
 |description=Функция записывает в буфер символы из UTF-16 (двухбайтной) строки по указанному индексу.
 }}
 {{function entry
@@ Line 234: / Line 242: @@
 |status=2
 |visual=0
-|description=Функция возвращает указатель в системной памяти на индексом смещения в буфере. '''Внимание''': при записи информации в буфер, его размер автоматически увеличивается, при этом данные буфера могут перемещаться в памяти, и возвращенный ранее указатель будет указывать на адрес в памяти более не принадлежащий буферу. При записи по этому адресу, данные в памяти будут испорчены, что приведет к непредсказуемым последствиям, начиная от внезапного завершения работы клиента, до общесистемного сбоя. Возвращенный указатель можно использовать только до изменения размеров буфера, после чего необходимо сновать вызвать функцию для получения обновленного указателя. Функция может использоваться в совокупности с функциями [[Объект загружаемой системной библиотеки|объекта загружаемой системной библиотеки]].
+|description=Функция возвращает указатель в системной памяти на индекс смещения в буфере. '''Внимание''': при записи информации в буфер, его размер автоматически увеличивается, при этом данные буфера могут перемещаться в памяти, и возвращенный ранее указатель будет указывать на адрес в памяти более не принадлежащий буферу. При записи по этому адресу, данные в памяти будут испорчены, что приведет к непредсказуемым последствиям, начиная от внезапного завершения работы клиента, до общесистемного сбоя. Возвращенный указатель можно использовать только до изменения размеров буфера, после чего необходимо сновать вызвать функцию для получения обновленного указателя. Функция может использоваться в совокупности с функциями [[Объект загружаемой системной библиотеки|объекта загружаемой системной библиотеки]].
 }}
 {{function footer}}

← Older revision	Revision as of 10:14, 8 June 2023
(No difference)

@@ Line 242: / Line 242: @@
 * Импорт или экспорт бинарных данных (к примеру, чтение формата ''BMP'' или ''WAV'' напрямую с диска)
 * Работа с [[Объект загружаемой системной библиотеки|функциями загружаемых системных библиотек]]. Функции часто работают со структурами данных, которые требуется разбирать или создавать для вызова функций библиотек.
-Объект позволяет создать запись любой сложности, однако существуют несущественные ограничения, которые можно легко обойти (в данный момент нельзя создать "массив массивов", требуется разделить массивы по разным записям и использовать одну запись внутри другой). Сама запись представляет структуру, не привязанную к памяти, поэтому после создания ее необходимо либо привязать к буферу ([[MemoryRecord.Assign|Assign]] или [[MemoryRecord.Allocate|Allocate]]), либо непосредственно к адресу системной памяти ([[MemoryRecord.AssignToSystemMemory|AssignToSystemMemory]]), после чего поля записи становятся доступными для чтения или записи. Дублирования записи осуществляется с помощью функции [[MemoryRecord.Copy|Copy]], при этом сама структура в памяти не дублируется, создается новая привязка к ней, поэтому, такой процесс происходит быстро и не затрачивает дополнительную память.
+Объект позволяет создать запись любой сложности, однако существуют несущественные ограничения, которые можно легко обойти (в данный момент нельзя создать "массив массивов", требуется разделить массивы по разным записям и использовать одну запись внутри другой). Сама запись представляет структуру, не привязанную к памяти, поэтому после создания ее необходимо либо привязать к буферу ([[MemoryRecord.Assign|Assign]] или [[MemoryRecord.Allocate|Allocate]]), либо непосредственно к адресу системной памяти ([[MemoryRecord.AssignToSystemMemory|AssignToSystemMemory]]), после чего поля записи становятся доступными для чтения или записи. Дублирование записи осуществляется с помощью функции [[MemoryRecord.Copy|Copy]], при этом сама структура в памяти не дублируется, создается новая привязка к ней, поэтому, такой процесс происходит быстро и не затрачивает дополнительную память.
 Для большей информации и примеров см. статью [[MemoryRecord.Create|Create]].

← Older revision	Revision as of 10:11, 13 March 2022
(No difference)

@@ Line 142: / Line 142: @@
 {{function entry
 |name=[[Buffer.GetString|GetString]]
-|form={{Grey|Buffer.}}'''GetString'''(''<Индекс буфера (INT)>'',''<Размер строки в байтах (INT)>''{{Optional|,''<Кодовая страница (INT)>''{{Default|{{Eq}}0}}}}):''<Результирующая строка (STRING)>''
+|form={{Grey|Buffer.}}'''GetString'''(''<Индекс буфера (INT)>''{{Optional|,<Размер строки в байтах (INT)>,<Кодовая страница (INT)>{{Default|{{Eq}}0}}}}):''<Результирующая строка (STRING)>''
 |type=1
 |status=2
@@ Line 158: / Line 158: @@
 {{function entry
 |name=[[Buffer.GetStringW|GetStringW]]
-|form={{Grey|Buffer.}}'''GetStringW'''(''<Индекс буфера (INT)>'',''<Размер строки в символах (INT)>):''<Результирующая строка (STRING)>''
+|form={{Grey|Buffer.}}'''GetStringW'''(''<Индекс буфера (INT)>''{{Optional|,<Размер строки в символах (INT)>}}):''<Результирующая строка (STRING)>''
 |type=1
 |status=2

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