IPythonUtils.Invoke

Синтаксис

Invoke(ModuleName: String; FunctionName: String; Params: Array): Variant;

Invoke(ModuleName: String; FunctionName: String; paramarray Params: Array of Object): Object;

Параметры

ModuleName. Наименование модуля с кодом на Python. Наименование является регистрозависимым.

FunctionName. Наименование выполняемой функции. Наименование является регистрозависимым.

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

Описание

Метод Invoke выполняет функцию на языке Python и возвращает результат её работы.

Комментарии

Перед выполнением каких-либо функций необходимо с помощью метода AddFolderToPythonPath задать папку, в которой расположен модуль Python. Если папка не определена, то поиск модуля производится в текущей папке, из которой была запущена аналитическая платформа.

Наименование модуля в параметре ModuleName указывается без расширения.

Если выполняемая функция не содержит входных параметров, то Params можно не указывать. Значения параметров в Params могут быть переданы в виде отдельного массива или перечислены через запятую. Значения простых типов, таких как String, Char, Integer, Double, Decimal, Currency, Boolean (типы str, int, float, bool в Python), передаются в соответствии с синтаксисом Fore без каких-либо преобразований. Значение Null соответствует значению None в языке Python. Если функция Python принимает в качестве входного параметра объект какого-либо класса Python, список или кортеж, то необходимо создать соответствующиё объект с помощью класса Fore: PythonClassObject, PythonList, PythonTuple.

Если функция имеет параметры со значениями по умолчанию и при выполнении необходимо передать только часть параметров, то используйте именованные параметры. Именованные параметры реализует класс PythonParameter. Создайте параметры с необходимыми наименованиями, задайте им значения и передайте их в метод Invoke.

Пример

Для выполнения примера предполагается наличие папки с модулями Python «d:\Work\Python\». В папке имеется модуль «sample.py». В модуле реализована следующая функция:

def summXY(x, y):
return x + y

Добавьте ссылку на системную сборку Python.

Sub UserProc;
Var
    pUtils: IPythonUtils;
    Result: Variant;
Begin
    pUtils := New PythonUtils.Create;
    pUtils.AddFolderToPythonPath("d:\Work\Python\");
    Result := pUtils.Invoke("sample", "summXY", 100, 500);
    Debug.WriteLine(Result);
End Sub UserProc;

Imports Prognoz.Platform.Interop.Python;

Public Shared Sub Main(Params: StartParams);
Var
    pUtils: IPythonUtils = New PythonUtilsClass();
    Result: object;
Begin
    pUtils.AddFolderToPythonPath("d:\Work\Python\");
    Result := pUtils.Invoke("sample", "summXY", 100, 500);
    System.Diagnostics.Debug.WriteLine(Result);
End Sub;

При выполнении примера будет выполнена функция на языке Python, осуществляющая сложение двух чисел, переданных в параметрах. Результат выполнения функции будет выведен в консоль среды разработки.

См. также:

IPythonUtils