Buffer.AddValues

From SunFlurry wiki
Revision as of 07:51, 22 January 2025 by Admin (talk | contribs) (1 revision imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
  AddValues (Изменение данных)
Объект:Буфер
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в число, отрицательных индекс.
Визуальность:Нет

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

Синтаксис

Buffer.AddValues(<Индекс буфера (INT)>,<Размер данных (INT)>,<Значение 1>,<Значение 2>,...)

Аргументы

  • <Индекс буфера (INT)> - (возможен аргумент-переменная (ByRef)) Позиция в буфере для записи. Адресация буфера начинается с нуля. Буфер будет автоматически увеличен при необходимости, для того, чтобы новые данные поместились в нем.
  • <Размер данных (INT)> - Размер (и тип) адресуемых данных, возможны следующие значения:
    • 1 -- адресуется один байт данных без знака.
    • -1 -- адресуется один байт данных со знаком.
    • 2 -- адресуется одно слово данных без знака.
    • -2 -- адресуется одно слово данных со знаком.
    • 4 -- адресуется одно двойное слово данных без знака.
    • -4 -- адресуется одно двойное слово данных со знаком.
    • 8 или -8 -- адресуется 64-битное число со знаком.
    • 104 -- адресуется вещественное число IEEE 754 Single (4 байта).
    • 108 -- адресуется вещественное число IEEE 754 Double (8 байт).
    • 110 -- адресуется вещественное число x87 Extended (10 байт).
  • <Значение N> - Числовые аргументы для последовательной записи в буфер.

Примеры

аБуф:=Buffer.Create();
//Записываем три слова (6 байт)
аБуф.AddValues(0,2,65280,65280,65280);
//Будет выведено число 4278255360
Message(аБуф[0,4]);
//Будет выведено число 16711935
Message(аБуф[1,-4]);