ExecEx - Revision history

Admin: 1 revision imported

2023-09-25T09:06:53Z

1 revision imported

1>Admin at 08:53, 17 August 2023

2023-08-17T08:53:58Z

Admin: 1 revision imported

2023-06-08T10:11:05Z

1 revision imported

1>Admin at 19:25, 1 May 2023

2023-05-01T19:25:51Z

Admin: 1 revision imported

2021-04-16T14:17:35Z

1 revision imported

1>Admin at 09:39, 4 April 2021

2021-04-04T09:39:12Z

Admin: 1 revision imported

2021-02-07T06:50:41Z

1 revision imported

Admin at 14:58, 26 December 2020

2020-12-26T14:58:03Z

New page

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

== Синтаксис ==
<code>
'''ExecEx'''(''<Блок для исполнения или компилированная функция (STRING, COMPILEDFUNCTION)>''{{Optional|,<Установки ограничения исполнения (INT)>{{Default|{{Eq}}0}},<Ограничение по времени в мс. (INT)>{{Default|{{Eq}}0}},<Наименование функции, получающей выводимую в лог информацию (STRING)>,<Глубина поиска (INT)>{{Default|{{Eq}}0}},<Ограничение по использованию памяти потоком (INT)>{{Default|{{Eq}}0}}}}):''<Значение переменной Result при исполнении функции>''
</code>
==== Аргументы ====
* <code>''<Блок для исполнения (STRING)>''</code> - Произвольный [[Общее описание языка#Инструкция языка|блок инструкций]], может содержать имена функций, переменных, операции, магические функции, особые конструкции, в т.ч. объявления новых функций. Ограничения на использование функций и доступу к переменным задается следующими аргументами. В случае, если аргумент является компилированной функцией (см. [[Compile]]), этап компиляции будет пропущен, однако на исполняемую компилированную функцию будут налагаться те же самые ограничения, как и на компилированный блок текста.
* <code>''<Установки ограничения исполнения (INT)>''</code> - {{Optional}} Аргумент задает ограничения доступа блока инструкций и является битовой маской. По умолчанию аргумент равен нулю (дополнительных запретов нет). Назначение битов аргумента следующее:
** '''бит 0''' (1) -- Запретить доступ ко всем переменным и функциям глобальных модулей. Программа может использовать только переменные и функции текущего модуля и экспортированные переменные и функции модулей, которые вызвали текущий. '''Внимание:''' функции, типа [[DB.Publish|Publish]] могут не работать с такими ограничениями, если в них происходит вызов глобальных функций.
** '''бит 1''' (2) -- Запретить доступ ко всем переменным и функциям глобальных модулей и локального модуля. Программа не сможет получить доступ к любым внешним переменным или функциям, включая глобальные и локальные, так и созданные на текущем уровне исполнения. '''Внимание:''' функции, типа [[DB.Publish|Publish]] могут не работать с такими ограничениями, если в них происходит вызов глобальных функций.
** '''бит 2''' (4) -- Запрещены любые функции диалога с пользователем (как функции, типа [[Box]], так и вывод таблиц или текстов на экран, к примеру [[Table.Show|Show]]).
** '''бит 3''' (8) -- Запрещен доступ к функциям профилирования ([[ProfilerStart]] и подобным).
** '''бит 4''' (16) -- Запрещен доступ к функции прерывания исполнения [[Debugbreak]].
** '''бит 5''' (32) -- Запрещен доступ к отладочным функциям (часто с префиксом ''dbg'', примеру, [[dbgStackTrace]]).
** '''бит 6''' (64) -- Запрещен доступ к функциям остановки работы системы, перезапуска и подобным (к примеру, [[ExitProgram]]).
** '''бит 7''' (128) -- Запрещен доступ к функциям запуска исполняемых файлов (к примеру, [[SysExec]]).
** '''бит 8''' (256) -- Запрещен доступ к функциям семафора, в том числе к функции [[Mutex.ExecuteFunctionInSeparateThread]] (однако создание событий [[Mutex.CreateEvent]] не запрещено).
** '''бит 9''' (512) -- Запрещен доступ к функциям загрузки модулей, типа [[LoadModule]] или [[OpenObject]].
** '''бит 10''' (1024) -- Запрещен доступ к функциям сохранения информации в файлы (в том числе в файлы на сервере базы данных), типа [[StringToFile]], [[File.DeleteFile]] или [[Table.Save]].
** '''бит 11''' (2048) -- Запрещен доступ к функциям чтения информации из файлов (в том числе из файлов на сервере базы данных), типа [[FileToString]], [[File.FindOpen]] или [[Table.Save]].
** '''бит 12''' (4096) -- Запрещен опасные функции буфера или записи, такие функции обычно оперируют абсолютными адресами системной памяти (к примеру, [[Buffer.SystemAddress]] или [[MemoryRecord.AssignToSystemMemory]]).
** '''бит 13''' (8192) -- Запрещено обращение к OLE-объектам.
** '''бит 14''' (16384) -- Запрещено обращение к любым [[Объект IP|IP функциям]].
** '''бит 15''' (32768) -- Запрещено обращение к любым функциям дополнительных внешних баз данных (к примеру, [[ExternalDBase.Connect]]).
** '''бит 16''' (65536) -- Запрещено обращение к любым [[Объект загружаемой системной библиотеки|функциям загружаемой системной библиотеки]].
** '''бит 17''' (131072) -- Запрещено обращение к системным функциям пересчета базы данных (которые обычно выполняются длительное время), к примеру [[DB.SysRecalcTotals]].
** '''бит 18''' (262144) -- Запрещено обращение к визуальным функциям [[Форма|формы]], включая функции типа [[Form.StatusText]], [[Form.Close]] или [[Form.Destroy]], но обращение к нейтральным функциям получения информации типа [[Form.IsFullyInitialized]], [[Form.ToolMode]] или [[Form.Mode]] разрешено.
** '''бит 19''' (524288) -- Запрещено использование функций работы с [[Картинка|картинками]], также как и работы с функциями штрихкодов, типа [[Generate2DBarcode]].
* <code>''<Ограничение по времени в мс. (INT)>''</code> - {{Optional}} Аргумент задает ограничения по времени исполнения блока инструкций, заданном в миллисекундах. Если после истечения указанного времени, программа будет продолжать исполняться, будет вызвано исключение, которое невозможно будет подавить. Если аргумент не указан или равен нулю, ограничения задано не будет. Нужно также понимать, что программа может прерваться только после исполнения инструкции во время подготовки новой инструкции для исполнения. Если же, к примеру, функция ''OLE'' исполняется в течение долгого времени, исполнение не будет прервано до тех пор, пока она не закончит исполнение. Однако, функции ожидания, типа [[Sleep]] будут прерываться до окончания истечения периода ожидания.
* <code>''<Наименование функции, получающей выводимую в лог информацию (STRING)>''</code> - {{Optional}} Аргумент задает наименование особой функции, которая будет получать весь консольный вывод в виде строк с метками форматирования. Если эта функция задана, любой вывод информации в консоль клиента будет перенаправлен в вызовы данной функции (в консоль эта информация не попадет). Функция должна исполняться как можно быстрее, чтобы не задерживать исполнение кода ExecEx, любые исключения внутри функции будут игнорированы. На функцию не распространяется ограничения, накладываемые на исполняемый код ''ExecEx'', однако время ее исполнения учитывается в ограничении времени исполнения кода ExecEx. В коде, для которого задана такая функция невозможно произвести вызов функции ''ExecEx'' с новой заданной функцией вывода (это позволяет избежать доступа из кода с ограничениями к среде без ограничений). Функция имеет следующий формат вызова <code><ФункцияПолученияЛога>(''<Новый текст, выводящийся в лог (STRING)>''{{Optional|<Тип текста (INT)>,<Метки форматирования текста (STRING)>}})</code>. Ниже дано описание аргументов функции:
** ''<Новый текст, выводящийся в лог (STRING)>'' - аргумент получает текстовую строку, которая была бы выведена в лог.
** ''<Тип текста (INT)>'' - {{Optional}} аргумент получает тип текстовой строки, доступны следующие типы:
*** '''-1''' -- эта строка является сообщением об ошибке.
*** '''0''' -- эта строка является обычным текстом (созданным, к примеру функциями [[Message]] или [[Writeln]]).
*** '''1''' -- эта строка является текстом созданным функцией [[Message]] с типом текста "i".
*** '''2''' -- эта строка является текстом созданным функцией [[Message]] с типом текста ".".
*** '''3''' -- эта строка является текстом созданным функцией [[Message]] с типом текста "!".
*** '''4''' -- эта строка является текстом созданным функцией [[Message]] с типом текста "!!".
*** '''5''' -- эта строка является текстом созданным функцией [[Message]] с типом текста "!!!".
** ''<Метки форматирования текста (STRING)>'' - {{Optional}} аргумент получает строку с метками форматирования текста. Иногда это будет пустая строка, если весь текст представляет собой строку без форматирования. В случае, когда строка задана, она отдается в виде ANSI, каждый ее символ может быть превращен в байт и будет задавать форматирование соответствующего символа в строке текста лога. Доступны следующие значения символов форматирования:
*** '''0''' -- Текущий символ строки лога использует стандартный цвет и шрифт (не форматирован).
*** '''1''' -- Текущий символ строки лога использует такой же цвет и шрифт, как и предыдущий символ.
*** '''2''' -- Текущий символ строки лога использует цвет и шрифт, заданные семью последующими символами строки с метками форматирования. Эти последующие символы должны быть пропущены при подсчете индекса символа строки лога (относятся только к текущему символу) и имеют следующее назначение:
**** 3 символа задают цвет шрифта (формате ''RGB'').
**** 3 символа задают цвет фона шрифта (формате ''RGB'').
**** 1 символ задает формат шрифта, является битовой маской с битами: ''0'' (жирный шрифт), ''1'' (наклонный шрифт), ''2'' (подчеркнутый шрифт), ''3'' (зачеркнутый шрифт).
* <code>''<Ограничение по использованию памяти потоком (INT)>''</code> - {{Optional}} {{Planned}}.

==== Возвращаемое значение ====
Возвращает значение переменной ''Result'', которую можно свободно использовать внутри исполняемого кода.

== Примеры ==
<pre>
//тЗапрос -- строка с кодом для исполнения
//Функция исполняет ее с определенными ограничениями и временем исполнения не более 5 секунд.
//Информация, получаемая в лог, переводится в html формат отсылается на удаленный сервер с помощью функции ПослатьСтроку (здесь не дана).

Function ПолучитьИПослатьСтроку(Стр,Тип,Стиль)
//Расшифровка строки
СтрРез:="";
ФлДив:=0;
i:=0;
j:=0;
While i<Length(Стиль) Do
i:=i+1;
j:=j+1;
Симв:=Asc(Стиль[i]);
If Симв=2 Then
//<Color3Bytes><BGColor3Bytes><FontStyle1Byte>
If ФлДив Then
AppendStringToBufferedString(СтрРез,"</span>");
EndIf;

аЦвет:=Asc(Стиль[i+1])*65536+Asc(Стиль[i+2])*256+Asc(Стиль[i+3]);
аЦвет2:=Asc(Стиль[i+4])*65536+Asc(Стиль[i+5])*256+Asc(Стиль[i+6]);
Фл:=Asc(Стиль[i+7]);

аСтиль:="";
аСтиль:=аСтиль+?(аЦвет=0,"","color:#"+Lowercase(DecToHex(аЦвет,6)));
аСтиль:=аСтиль+?(аЦвет2=0,"",?(аСтиль<>"","; ")+"background-color:#"+Lowercase(DecToHex(аЦвет2,6)));
//bold(0),italic(1),underlined(2),strikeout(3)
If Фл%2=1 Then
аСтиль:=аСтиль+?(аСтиль<>"","; ")+"font-weight:bold";
EndIf;
If Фл\2%2=1 Then
аСтиль:=аСтиль+?(аСтиль<>"","; ")+"font-style:italic";
EndIf;
If Фл\4%4<>0 Then
аСтиль:=аСтиль+?(аСтиль<>"","; ")+"text-decoration:";
If Фл\4%2<>0 Then
аСтиль:=аСтиль+" underline";
EndIf;
If Фл\8%2<>0 Then
аСтиль:=аСтиль+" line-through";
EndIf;
EndIf;
i:=i+7;
ФлДив:=0;
if аСтиль<>"" Then
AppendStringToBufferedString(СтрРез,"<span style="""+аСтиль+";"">");
ФлДив:=1;
EndIf;
ElseIf (Симв=0)And(ФлДив) Then
AppendStringToBufferedString(СтрРез,"</span>");
ФлДив:=0;
EndIf;
AppendStringToBufferedString(СтрРез,EncodeXMLString(Стр[j]));
EndDo;
If ФлДив Then
AppendStringToBufferedString(СтрРез,"</span>");
EndIf;
AppendStringToBufferedString(СтрРез,Mid(Стр,j+1));
ПослатьСтроку(СтрРез);
EndFunction

Try
ExecEx(тЗапрос,0b1111111111111111111,5000,"ПолучитьИПослатьСтроку");
Except
EndTry;
</pre>

← Older revision	Revision as of 09:06, 25 September 2023
(No difference)

@@ Line 44: / Line 44: @@
 ** '''бит 20''' (1048576) -- Запрещено использование функций, работающих с сервером, если эти функции можно использовать для нарушения работы сервера (к примеру, выполнить [[StoreGlobalTempString]] миллионы раз со случайными строками, с тем, чтобы заполнить память сервера).
 * <code>''<Ограничение по времени в мс. (INT)>''</code> - {{Optional}} Аргумент задает ограничения по времени исполнения блока инструкций, заданном в миллисекундах. Если после истечения указанного времени, программа будет продолжать исполняться, будет вызвано исключение, которое невозможно будет подавить. Если аргумент не указан или равен нулю, ограничения задано не будет. Нужно также понимать, что программа может прерваться только после исполнения инструкции во время подготовки новой инструкции для исполнения. Если же, к примеру, функция ''OLE'' исполняется в течение долгого времени, исполнение не будет прервано до тех пор, пока она не закончит исполнение. Однако, функции ожидания, типа [[Sleep]] будут прерываться до окончания истечения периода ожидания.
-* <code>''<Наименование функции, получающей выводимую в лог информацию (STRING)>''</code> - {{Optional}} Аргумент задает наименование особой функции, которая будет получать весь консольный вывод в виде строк с метками форматирования. Если эта функция задана, любой вывод информации в консоль клиента будет перенаправлен в вызовы данной функции (в консоль эта информация не попадет). Функция должна исполняться как можно быстрее, чтобы не задерживать исполнение кода ExecEx, любые исключения внутри функции будут игнорированы. На функцию не распространяется ограничения, накладываемые на исполняемый код ''ExecEx'', однако время ее исполнения учитывается в ограничении времени исполнения кода ExecEx. В коде, для которого задана такая функция невозможно произвести вызов функции ''ExecEx'' с новой заданной функцией вывода (это позволяет избежать доступа из кода с ограничениями к среде без ограничений). Функция имеет следующий формат вызова <code><ФункцияПолученияЛога>(''<Новый текст, выводящийся в лог (STRING)>''{{Optional|<Тип текста (INT)>,<Метки форматирования текста (STRING)>}})</code>. Ниже дано описание аргументов функции:
+* <code>''<Наименование функции, получающей выводимую в лог информацию (STRING)>''</code> - {{Optional}} Аргумент задает наименование особой функции, которая будет получать весь консольный вывод в виде строк с метками форматирования. Если эта функция задана, любой вывод информации в консоль клиента будет перенаправлен в вызовы данной функции (в консоль эта информация не попадет). Функция должна исполняться как можно быстрее, чтобы не задерживать исполнение кода ExecEx, любые исключения внутри функции будут игнорированы. На функцию не распространяется ограничения, накладываемые на исполняемый код ''ExecEx'', однако время ее исполнения учитывается в ограничении времени исполнения кода ExecEx. В коде, для которого задана такая функция невозможно произвести вызов функции ''ExecEx'' с новой заданной функцией вывода (это позволяет избежать доступа из кода с ограничениями к среде без ограничений). Функция имеет следующий формат вызова <code><ФункцияПолученияЛога>(''<Новый текст, выводящийся в лог (STRING)>''{{Optional|<Тип текста (INT)>,<Метки форматирования текста (STRING)>,<Параметр не используется>,<Список интерактивных объектов %LINK% (LIST)>}})</code>. Ниже дано описание аргументов функции:
 ** ''<Новый текст, выводящийся в лог (STRING)>'' - аргумент получает текстовую строку, которая была бы выведена в лог.
 ** ''<Тип текста (INT)>'' - {{Optional}} аргумент получает тип текстовой строки, доступны следующие типы:
@@ Line 61: / Line 61: @@
 **** 3 символа задают цвет фона шрифта (формате ''RGB'').
 **** 1 символ задает формат шрифта, является битовой маской с битами: ''0'' (жирный шрифт), ''1'' (наклонный шрифт), ''2'' (подчеркнутый шрифт), ''3'' (зачеркнутый шрифт).
 * <code>''<Глубина поиска (INT)>''</code> - {{Optional}} Может принимать следующие значения:
 ** 0 (по умолчанию) -- выполнять поиск функции во всех модулях [[Общее описание языка#Вложенность функций и модулей, уровни вложенности|большего уровня вложенности]] (родительских) и во всех глобальных модулях.

← Older revision	Revision as of 10:11, 8 June 2023
(No difference)

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Функции общего назначения]]}}
-Функция производит компиляцию и исполнение блока текста, заданного на внутреннем языке, или компилированной заранее функции в контролируемой среде исполнения. Аргументы могут ограничить возможности, предоставляемые исполняемому коду, как функционально (некоторые группы функций будут запрещены к использованию), или в заданных пределах доступа к переменным и функциям, так и с ограничением по времени исполнения или по выделяемой памяти. Функция может использоваться для исполнения кода, который может быть опасным или злонамеренным, либо кода из неизвестного источника. В отличие от функции [[Exec]], текущая использует переменную ''Result'' внутри исполняемого кода, как результат выполнения функции, это может быть важно, если из кода запрещен доступ к любым внешним переменным, поэтому, нет простой возможности передать данные во внешнюю среду. Для онлайн демонстрации работы функции, см. [[Пример исполнения программного кода|следующую статью]].
+Функция производит компиляцию и исполнение блока текста, заданного на внутреннем языке, или компилированной заранее функции в контролируемой среде исполнения. Аргументы могут ограничить возможности, предоставляемые исполняемому коду, как функционально (некоторые группы функций будут запрещены к использованию), или в заданных пределах доступа к переменным и функциям, так и с ограничением по времени исполнения или по выделяемой памяти. Функция может использоваться для исполнения кода, который может быть опасным или злонамеренным, либо кода из неизвестного источника. В отличие от функции [[Exec]], текущая использует переменную ''Result'' внутри исполняемого кода, как результат выполнения функции, это может быть важно, если из кода запрещен доступ к любым внешним переменным, поэтому, нет простой возможности передать данные во внешнюю среду. Также см. функцию [[StandardOutputHook]]. Для онлайн демонстрации работы функции, см. [[Пример исполнения программного кода|следующую статью]].
 == Синтаксис ==
@@ Line 61: / Line 61: @@
 **** 3 символа задают цвет фона шрифта (формате ''RGB'').
 **** 1 символ задает формат шрифта, является битовой маской с битами: ''0'' (жирный шрифт), ''1'' (наклонный шрифт), ''2'' (подчеркнутый шрифт), ''3'' (зачеркнутый шрифт).
 * <code>''<Ограничение по использованию памяти потоком (INT)>''</code> - {{Optional}} {{Planned}}.

← Older revision	Revision as of 14:17, 16 April 2021
(No difference)

@@ Line 42: / Line 42: @@
 ** '''бит 18''' (262144) -- Запрещено обращение к визуальным функциям [[Форма|формы]], включая функции типа [[Form.StatusText]], [[Form.Close]] или [[Form.Destroy]], но обращение к нейтральным функциям получения информации типа [[Form.IsFullyInitialized]], [[Form.ToolMode]] или [[Form.Mode]] разрешено.
 ** '''бит 19''' (524288) -- Запрещено использование функций работы с [[Картинка|картинками]], также как и работы с функциями штрихкодов, типа [[Generate2DBarcode]].
 * <code>''<Ограничение по времени в мс. (INT)>''</code> - {{Optional}} Аргумент задает ограничения по времени исполнения блока инструкций, заданном в миллисекундах. Если после истечения указанного времени, программа будет продолжать исполняться, будет вызвано исключение, которое невозможно будет подавить. Если аргумент не указан или равен нулю, ограничения задано не будет. Нужно также понимать, что программа может прерваться только после исполнения инструкции во время подготовки новой инструкции для исполнения. Если же, к примеру, функция ''OLE'' исполняется в течение долгого времени, исполнение не будет прервано до тех пор, пока она не закончит исполнение. Однако, функции ожидания, типа [[Sleep]] будут прерываться до окончания истечения периода ожидания.
 * <code>''<Наименование функции, получающей выводимую в лог информацию (STRING)>''</code> - {{Optional}} Аргумент задает наименование особой функции, которая будет получать весь консольный вывод в виде строк с метками форматирования. Если эта функция задана, любой вывод информации в консоль клиента будет перенаправлен в вызовы данной функции (в консоль эта информация не попадет). Функция должна исполняться как можно быстрее, чтобы не задерживать исполнение кода ExecEx, любые исключения внутри функции будут игнорированы. На функцию не распространяется ограничения, накладываемые на исполняемый код ''ExecEx'', однако время ее исполнения учитывается в ограничении времени исполнения кода ExecEx. В коде, для которого задана такая функция невозможно произвести вызов функции ''ExecEx'' с новой заданной функцией вывода (это позволяет избежать доступа из кода с ограничениями к среде без ограничений). Функция имеет следующий формат вызова <code><ФункцияПолученияЛога>(''<Новый текст, выводящийся в лог (STRING)>''{{Optional|<Тип текста (INT)>,<Метки форматирования текста (STRING)>}})</code>. Ниже дано описание аргументов функции:

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