Difference between revisions of "Buffer.AppendToFile"

From SunFlurry wiki
Jump to: navigation, search
(Created page with "{{infobox function |name=AppendToFile |object=Буфер |caption=Сохранение в файл |type=1 |status=2 |db=1 |exception=Ошибка сервера, нево...")
 
m (1 revision imported)
 
(No difference)

Latest revision as of 08:43, 7 February 2021

  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);