Compile - Revision history

Admin: 1 revision imported

2022-11-18T09:36:24Z

1 revision imported

1>Admin at 18:12, 19 September 2022

2022-09-19T18:12:35Z

Admin: 1 revision imported

2021-11-20T17:03:50Z

1 revision imported

1>Admin at 14:07, 27 July 2021

2021-07-27T14:07:55Z

Admin: 1 revision imported

2021-02-07T06:43:14Z

1 revision imported

Admin at 13:33, 28 December 2020

2020-12-28T13:33:26Z

New page

{{infobox function
|name=Compile
|object=[[Функции общего назначения]]
|caption=Системные функции
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число, ошибка в выражении
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция производит компиляцию блока текста, заданного на внутреннем языке, и возвращает объект, представляющий результат компиляции. В зависимости от второго аргумента, блок может компилироваться в контексте текущей функции, глобальных модулей или без доступа к внешним переменным и функциям. Функция вызывает прерывание, если компиляция прервана из-за ошибки. Результирующий объект можно использовать многократно с функциями [[Exec]] и [[ExecEx]], это быстрее, чем компилировать блок текста при каждом вызове. Несмотря на называние, в блок является набором произвольных инструкций и функций, а не одной функцией, иными словами, блок текста может быть произвольным модулем.

== Синтаксис ==
<code>
'''Compile'''(''<Блок для компилирования (STRING)>''{{Optional|,<Степень изолированности (INT)>{{Default|{{Eq}}0}}}}):''<Компилированная функция в виде объекта (COMPILEDFUNCTION)>''
</code>
==== Аргументы ====
* <code>''<Блок для компилирования (STRING)>''</code> - Произвольный [[Общее описание языка#Инструкция языка|блок инструкций]], может содержать имена функций, переменных, операции, магические функции, особые конструкции, в т.ч. объявления новых функций.
* <code>''<Степень изолированности (INT)>''</code> - {{Optional}} Аргумент задает среду компиляции, и может принимать следующие значения:
** '''0''' (по умолчанию) -- производить компиляцию в контексте текущей функции (в которой вызвана функция ''Compile''). Это дает возможность использовать все переменные и все локальные функции текущий функции, а также глобальные переменные и функции.
** '''1''' -- производить компиляцию в глобальных функций. Это дает возможность использовать в блоке текста только глобальные переменные и функции. Такой вариант изолированности предпочтительнее, если функция в дальнейшем будет экспортирована с помощью [[SaveFunctionToBuffer]].
** '''2''' -- производить компиляцию без доступа к внешним функциям и переменным. Это полностью изолирует компилируемую функцию. Нужно, однако, понимать, что блок по-прежнему может косвенно вызывать внешние функции, являющиеся событиями, к примеру, с помощью функции [[DB.Publish|Publish]] или подобных.

==== Возвращаемое значение ====
Возвращает новый объект компилированной функции, который можно исполнить с помощью функций [[Exec]] и [[ExecEx]], либо экспортировать в память с помощью [[SaveFunctionToBuffer]].

== Примеры ==
<pre>
//Пример из статьи ProfilerStart дополняется четвертым тестом с заранее компилированной функцией.

Function Square(a)
Exit a*a;
EndFunction

//Включить режим отладки
DebuggingRights(1);

//Очистить предыдущие результаты профилирования
ProfilerClear;

//Включить профайлер
ProfilerStart;

//Находим разницу во времени выполнения функции разными способами
For i:=1 to 100000 Do
Square(i);
EndDo;

For i:=1 to 100000 Do
ExecuteFunction("Square",1,i);
EndDo;

Стр:="Square(i);";
aFunc:=Compile(Стр);
For i:=1 to 100000 Do
Exec(aFunc);
EndDo;

//Останавливаем профайлер
ProfilerStop;

Период:=dbgHRPCCurrent();
For i:=1 to 100000 Do
Exec("Square(i)");
EndDo;
Период:=dbgHRPCGetPeriod(Период)/1000000;
Message("Выполнение Exec: "+Период+" мс.");

//Вызываем окно отладчика для просмотра результатов профилирования
DebugBreak;

//Функция DebugBreak не должна быть последней в модуле
Message("Тест выполнен успешно");

//Для i5 на Windows 7 результаты профилирования были следующими:
//* Прямой вызов функции занял 229 мс.
//* Использование функции ExecuteFunction заняло 307 мс.
//* Использование заранее скомпилированной функции заняло 357 мс.
//* Компиляция текста и вызов функции заняли 1181 мс.
// Комментарий: компиляция и выполнение уменьшает скорость работы профайлера, так как увеличивается количество исходных текстов в массиве, из которого производится поиск при профилировании
// Для массива текстов размером в ~10000, профайлер замедляет исполнение примерно в 1.4 раза по сравнению с работой профайлера с пустым массивом (коэффициент можно найти, если переставить местами
// циклы, включить цикл Exec в профилирование и сравнить результаты). Поэтому, время исполнения последнего цикла было найдено без помощи профайлера.

//Вывод: Для случая заранее скомпилированной функции скорость исполнения для этого примера выше в 3.3 раза по сравнению с компиляцией и исполнением.
// Для текстов с большим количеством быстро исполняемых инструкций, эта разница будет только возрастать.
// Скорость исполняемой заранее скомпилированной функции почти не уступает скорости обычного исполнения. См. также статью ProfilerStart
</pre>

← Older revision	Revision as of 09:36, 18 November 2022
(No difference)

@@ Line 17: / Line 17: @@
 == Синтаксис ==
 <code>
-'''Compile'''(''<Блок для компилирования (STRING)>''{{Optional|,<Степень изолированности (INT)>{{Default|{{Eq}}0}}}}):''<Компилированная функция в виде объекта (COMPILEDFUNCTION)>''
+'''Compile'''(''<Блок для компилирования (STRING)>''{{Optional|,<Степень изолированности (INT)>{{Default|{{Eq}}0}},<Добавочные переменные (STRING)>,<Свойства исходного текста для отладчика (STRING,INT)>}}):''<Компилированная функция в виде объекта (COMPILEDFUNCTION)>''
 </code>
 ==== Аргументы ====
@@ Line 25: / Line 25: @@
 ** '''1''' -- производить компиляцию в контексте глобальных функций. Это дает возможность использовать в блоке текста только глобальные переменные и функции. Такой вариант изолированности предпочтительнее, если функция в дальнейшем будет экспортирована с помощью [[SaveFunctionToBuffer]].
 ** '''2''' -- производить компиляцию без доступа к внешним функциям и переменным. Это полностью изолирует компилируемую функцию. Нужно, однако, понимать, что блок по-прежнему может косвенно вызывать внешние функции, являющиеся событиями, к примеру, с помощью функции [[DB.Publish|Publish]] или подобных.
 ==== Возвращаемое значение ====

← Older revision	Revision as of 17:03, 20 November 2021
(No difference)

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Функции общего назначения]]}}
-Функция производит компиляцию блока текста, заданного на внутреннем языке, и возвращает объект, представляющий результат компиляции. В зависимости от второго аргумента, блок может компилироваться в контексте текущей функции, глобальных модулей или без доступа к внешним переменным и функциям. Функция вызывает прерывание, если компиляция прервана из-за ошибки. Результирующий объект можно использовать многократно с функциями [[Exec]] и [[ExecEx]], это быстрее, чем компилировать блок текста при каждом вызове. Несмотря на называние, в блок является набором произвольных инструкций и функций, а не одной функцией, иными словами, блок текста может быть произвольным модулем.
+Функция производит компиляцию блока текста, заданного на внутреннем языке, и возвращает объект, представляющий результат компиляции. В зависимости от второго аргумента, блок может компилироваться в контексте текущей функции, глобальных модулей или без доступа к внешним переменным и функциям. Функция вызывает прерывание, если компиляция прервана из-за ошибки. Результирующий объект можно использовать многократно с функциями [[Exec]] и [[ExecEx]], это быстрее, чем компилировать блок текста при каждом вызове. Блок текста может представлять собой набор произвольных инструкций и функций, а не одну функцию, т.е. блок текста может быть модулем.
 == Синтаксис ==
@@ Line 22: / Line 22: @@
 * <code>''<Блок для компилирования (STRING)>''</code> - Произвольный [[Общее описание языка#Инструкция языка|блок инструкций]], может содержать имена функций, переменных, операции, магические функции, особые конструкции, в т.ч. объявления новых функций.
 * <code>''<Степень изолированности (INT)>''</code> - {{Optional}} Аргумент задает среду компиляции, и может принимать следующие значения:
-** '''0''' (по умолчанию) -- производить компиляцию в контексте текущей функции (в которой вызвана функция ''Compile''). Это дает возможность использовать все переменные и все локальные функции текущий функции, а также глобальные переменные и функции.
+** '''0''' (по умолчанию) -- производить компиляцию в контексте текущей функции (в которой вызвана функция ''Compile''). Это дает возможность использовать все переменные и все локальные функции текущей функции, а также глобальные переменные и функции.
-** '''1''' -- производить компиляцию в глобальных функций. Это дает возможность использовать в блоке текста только глобальные переменные и функции. Такой вариант изолированности предпочтительнее, если функция в дальнейшем будет экспортирована с помощью [[SaveFunctionToBuffer]].
+** '''1''' -- производить компиляцию в контексте глобальных функций. Это дает возможность использовать в блоке текста только глобальные переменные и функции. Такой вариант изолированности предпочтительнее, если функция в дальнейшем будет экспортирована с помощью [[SaveFunctionToBuffer]].
 ** '''2''' -- производить компиляцию без доступа к внешним функциям и переменным. Это полностью изолирует компилируемую функцию. Нужно, однако, понимать, что блок по-прежнему может косвенно вызывать внешние функции, являющиеся событиями, к примеру, с помощью функции [[DB.Publish|Publish]] или подобных.

← Older revision	Revision as of 06:43, 7 February 2021
(No difference)