loadtablefunctionpack

Синтаксис

p_id = loadtablefunctionpack(name);

Аргументы


Имя	Тип данных	Описание
name	string	Путь к файлу MiniExcel (*.tbl)

Описание

loadtablefunctionpack(name) – функция чтения файла, представляющего из себя пакет таблиц, созданный при помощи инструмента MiniExcel. Возвращает идентификатор пакета таблиц. По окончании работы с пакетом таблиц его необходимо уничтожить при помощи freeobject.

В функции предусмотрены проверки на корректность имени файла и корректность данных, которые в нем хранятся (Табл. 1).

Табл. 1. Возможные ошибки и причины их возникновения
Ошибка	Возможная причина
Файл не найден	Неправильно задан путь к файлу. Опечатка в имени файла
Файл занят другим процессом	Файл открыт другим приложением. Файл находится в процессе копирования/перемещения
Формат файла не поддерживается	Файл не является пакетом таблиц инструмента MiniExcel. Структура файла *.tbl нарушена
Невозможно загрузить табличные данные из файла / Таблица с индексом "X" содержит значение с некорректным числовым форматом	Одна или несколько таблиц / Таблица с индексом "X" содержит(ат) значения, которые невозможно интерпретировать как число
Ошибка выделения памяти под переменную / Неизвестная ошибка	-

Результат


Имя	Тип данных	Описание
p_id	integer	Идентификатор прочитанного пакета таблиц

Пример

initialization
  var
    p_id: integer;
  // Получение идентификатора
  p_id = loadtablefunctionpack("file1.tbl");
end;

var
  X: double,
  Y: double,
  Res: boolean;
// В качестве значения аргумента передается текущее модельное время
X = time;
// Получение значения: из пакета таблиц с идентификатором "p_id",
// таблица с индексом "2", функциональная зависимость - "1",
// используется линейная интерполяция - "0"
Res = gettablefunctionvalue(p_id, 2, 1, 0, X, Y);

finalization
  // Удаление пакета таблиц при окончании моделирования
  freeobject(p_id);
end;

В результате выполнения скрипта будет получен идентификатор пакета таблиц p_id.

Функция loadtablefunctionpack(name) считывает данные из файла name один раз при срабатывании. Поэтому изменения в файле name в процессе моделирования не влияют на результат использования остальных функций работы с файлами MiniExcel. Для вступления изменений в файле name в силу необходимо переинициализировать проект. Будет получен новый идентификатор пакета таблиц с обновленными данными.

Сопутствующие материалы

Материалов нет.