Buffer.AppendToFile

From SunFlurry wiki
Revision as of 11:41, 8 February 2020 by Admin (talk | contribs) (Created page with "{{infobox function |name=AppendToFile |object=Буфер |caption=Сохранение в файл |type=1 |status=2 |db=1 |exception=Ошибка сервера, нево...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
  AppendToFile (Сохранение в файл)
Объект:Буфер
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Сервер
Исключения:Ошибка сервера, невозможно превратить в строку, число, системная ошибка, чтение за пределами буфера.
Визуальность:Нет

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

Синтаксис

Buffer.AppendToFile(<Путь и имя файла (STRING)>,<Индекс буфера (INT)>=0,<Количество байтов для записи (INT)>)

Аргументы

  • <Путь и имя файла (STRING)> - Путь к файлу для сохранения. Путь может быть как серверным и так и локальным (Имена файлов).
  • <Индекс буфера (INT)> - (необязательный аргумент) Начальная позиция в буфере. Если позиция не указана, запись будет происходить с начала буфера. Позиция задается в байтах.
  • <Количество байтов для записи (INT)> - (необязательный аргумент) Размер сохраняемой области в байтах. Если аргумент не указан, информация будет скопирована с указанной позиции в буфере до конца буфера.

Примеры

аБуф:=Buffer.Create();
аБуф.Fill(0,65536,65280,1);
аБуф.SaveToFile("C:\testfile.bin",10000,20000);
аБуф.Fill(0,65536,85);
аБуф.AppendToFile("C:\testfile.bin",0,10000);