Команды для работы с файлами в Orion Assistant 2.0

Группа команд для работы с текстовыми файлами для Orion Assistant 2.0.

Формат команд:

ReturnType NameSpace.name(requiredParameters, [optionalParameters=defaultValue]);

• ReturnType - возвращаемое значение функции (void - функция ничего не возвращает);

• NameSpace - область видимости функции;

• name - имя функции;

• requiredParameters - обязательные параметры;

• optionalParameters - не обязательные параметры, значение по умолчанию указано после знака =

---

FileObject Orion.NewFile();

Создать объект файла.

---

bool fileObject.Open('filePath', [checkExists=false]);

Попытка открытия файла (либо создания нового) по пути filePath.

(Introduced in OA 2.0.15.0) checkExists - если установлено в true - проверяет наличие файла перед открытием, возвращает false не открывая файл, если его не существует. Актуально для открытия на чтением файла, но не на запись.

Результат: true в случае успешного открытия файла.

---

bool fileObject.Append('filePath', [checkExists=false]);

Попытка открытия файла по пути filePath на дозапись (указатель на данные ставится в конец файла).

(Introduced in OA 2.0.15.0) checkExists - если установлено в true - проверяет наличие файла перед открытием, возвращает false не открывая файл, если его не существует. Актуально для открытия на чтением файла, но не на запись.

Результат: true в случае успешного открытия файла.

---

bool fileObject.Opened();

Проверка валидности открытия файла.

Результат: true если файл открыт.

---

void fileObject.Close();

Закрыть файл.

---

String fileObject.ReadLine();

Прочитать строку до переноса строки (\n).

Результат: Результат чтения данных.

---

String fileObject.Read();

Прочитать слово (до пробела).

Результат: Результат чтения данных.

---

void fileObject.WriteLine('data');

Записать строку данных и перенос строки (\n).

---

void fileObject.Write('data');

Записать данные.

---

Introduced in 2.0.16.0

void fileObject.Remove(['filePath']);

Удалить файл по пути filePath.

Если filePath не указан - текущий файл закрывается (если он открыт) и ассистент пытается удалить его.