Mutex.ExecuteFunctionInSeparateThread - Revision history

Admin: 1 revision imported

2026-04-01T09:59:36Z

1 revision imported

1>Admin at 16:20, 8 January 2026

2026-01-08T16:20:30Z

Admin: 1 revision imported

2025-01-22T06:54:21Z

1 revision imported

1>Admin at 16:53, 30 December 2024

2024-12-30T16:53:22Z

Admin: 1 revision imported

2022-03-13T10:10:13Z

1 revision imported

1>Admin at 10:09, 30 January 2022

2022-01-30T10:09:23Z

Admin: 1 revision imported

2021-11-20T17:08:37Z

1 revision imported

1>Admin at 05:51, 27 August 2021

2021-08-27T05:51:44Z

Admin: 1 revision imported

2021-02-07T06:51:51Z

1 revision imported

Admin: /* Примеры */

2020-04-18T10:00:16Z

‎Примеры

New page

{{infobox function
|name=ExecuteFunctionInSeparateThread
|object=[[Функции общего назначения#Объект семафор|Семафор]]
|caption=Работа с подчиненными потоками
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число, неверные параметры вызова, системная ошибка
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения#Объект семафор|Семафор]]}}
Функция инициирует исполнение функции с указанным именем в новом подчиненном потоке с заданными аргументами, способ поиска задается вторым аргументом. Если искомая функция не существует, пропущен обязательный аргумент или заданное количество аргументов слишком велико, будет создано исключение. Созданный поток будет автоматически завершен, если выполнение функции завершится (в т.ч. из-за исключения), либо если основной поток будет завершен. При завершении подчиненного потока, система не ждет полного окончания завершения, так как оно может занять продолжительное время, если функция выполняет внешний вызов OLE и пр., чтобы убедиться, что поток завершен, можно использовать функцию [[Mutex.TerminateThread|TerminateThread]]. Функция может быть вызвана для интерфейса Mutex. Некоторые важные свойства функций, исполняемых в отдельных потоках:
* Если создание такой функции инициировано корневым потоком, функция не будет завершена автоматически и будет находиться в памяти до тех пор, пока клиент не будет закрыт, либо программа не вызовет функцию [[Mutex.TerminateThread|TerminateThread]].
* Исполняемая функция не обязательно должна быть корневой функцией текущего модуля, возможен, к примеру, вызов функции, подчиненной текущей функции, либо функции родительского или глобального модулей.
* Функция, исполняемая в отдельном потоке, может вызывать все функции, находящиеся в текущем модуле, однако, она '''не будет иметь доступа''' к экспортированным переменным этого модуля (так как исполнение фактически происходит в другом модуле). Для работы с переменными или значениями из вызвавшего модуля, функция может использовать набор своих аргументов или экспортируемые переменные глобальных модулей.
* В отличие от функции [[ExecuteFunction]], для аргументов функции не будет работать признак ''ByRef'', так как вызвавший поток не ожидает завершения выполнения функции и продолжает работать параллельно с новым.
* Необработанные исключения внутри функции останавливают ее выполнение, однако информация об этих исключениях будет поглощена и выведена в лог не будет (отладчик, однако, будет открыт в момент создания исключения, если режим отладки для визуального клиента разрешен).
* Исполнение таких функций происходит быстрее, чем вызов новых модулей в отдельных потоках с помощью [[LoadModule]].

== Синтаксис ==
<code>
{{Grey|Mutex.}}'''ExecuteFunctionInSeparateThread'''(''<Имя функции (STRING)>''{{Optional|,<Глубина поиска (INT)>{{Default|{{Eq}}0}},<Аргумент 1>,<Аргумент 2>...}}):''<Указатель на среду функции (MUTEX)>''
</code>
==== Аргументы ====
* <code>''<Имя функции (STRING)>''</code> - Имя функции, которую необходимо исполнить
* <code>''<Глубина поиска (INT)>''</code> - {{Optional}} Может принимать следующие значения:
** 0 (по умолчанию) -- выполнять поиск по всех модулях [[Общее описание языка#Вложенность функций и модулей, уровни вложенности|большего уровня вложенности]] (родительских) и во всех глобальных модулях.
** 1 -- выполнять поиск только внутри текущего модуля.
** 2 -- выполнять поиск только внутри родительского модуля.
** 3..x -- выполнять поиск только внутри родительского модуля указанного уровня (к примеру, для уровня 3, выполнять поиск только в родителе родителя текущего модуля).
* <code>''<Аргумент ?>''</code> - {{Optional}} Аргументы, передаваемые исполняемой функции

==== Возвращаемое значение ====
Возвращает объект семафора, указывающего на новый запущенный поток. В дальнейшем этот объект можно использовать с функциями, типа [[Mutex.TerminateThread|TerminateThread]]. Если поток не удалось запустить, по каким-либо причинам, функция либо вызывает исключение, либо отдает объект, для которого функция [[Mutex.IsThreadActive|IsThreadActive]] возвращает ноль.

== Примеры ==
<pre>
//Пример выполняет параллельный процесс отправки данных и обновляет индикатор его выполнения

Function ВыполнитьПроцесс(спДанные)
Форма:=спДанные.GetByName("Форма");
TCP:=спДанные.GetByName("Соединение");
аСтр:=спДанные.GetByName("Данные");
аВсего:=Length(аСтр);
аОтослано:=0;
Фл:=1;
//Цикл отсылает данные и обновляет текстовое поле на форме
While Length(аСтр)>0 Do
аСтр2:=Left(аСтр,1024);
аСтр:=Mid(аСтр,1025);
Try
TCP.SendStrRaw(аСтр2);
Except
Фл:=0;
Break;
EndTry;
аОтослано:=аОтослано+Length(аСтр2);
Форма.оИндикатор.Caption:="Выполнено: "+Round(аОтослано/аВсего,2)+"%";
EndDo;
If Фл Then
Форма.оИндикатор.Caption:="Отправка выполнена успешно!";
Else
Форма.оИндикатор.Caption:="Ошибка при отправке!";
EndIf;
EndFunction

//Подготовка данных аСтр, соединение с удаленным сервером TCP

спДанные:=List.Create();
спДанные.SetByName("Форма",Form.ThisForm());
спДанные.SetByName("Соединение",TCP);
спДанные.SetByName("Данные",аСтр);
Mutex.ExecuteFunctionInSeparateThread("ВыполнитьПроцесс",0,спДанные);

...
</pre>

← Older revision	Revision as of 09:59, 1 April 2026
(No difference)

@@ Line 28: / Line 28: @@
 * <code>''<Имя функции (STRING)>''</code> - Имя функции, которую необходимо исполнить
 * <code>''<Глубина поиска (INT)>''</code> - {{Optional}} Может принимать следующие значения:
 ** 0 (по умолчанию) -- выполнять поиск по всех модулях [[Общее описание языка#Вложенность функций и модулей, уровни вложенности|большего уровня вложенности]] (родительских) и во всех глобальных модулях.
 ** 1 -- выполнять поиск только внутри текущего модуля.

← Older revision	Revision as of 06:54, 22 January 2025
(No difference)

@@ Line 16: / Line 16: @@
 * Если создание такой функции инициировано корневым потоком, функция не будет завершена автоматически и будет находиться в памяти до тех пор, пока клиент не будет закрыт, либо программа не вызовет функцию [[Mutex.TerminateThread|TerminateThread]].
 * Исполняемая функция не обязательно должна быть корневой функцией текущего модуля, возможен, к примеру, вызов функции, подчиненной текущей функции, либо функции родительского или глобального модулей.
-* Функция, исполняемая в отдельном потоке, может вызывать все функции, находящиеся в текущем модуле, однако, она '''не будет иметь доступа''' к экспортированным переменным этого модуля (так как исполнение фактически происходит в другом модуле). Для работы с переменными или значениями из вызвавшего модуля, функция может использовать набор своих аргументов или экспортируемые переменные глобальных модулей.
+* Функция, исполняемая в отдельном потоке, может вызывать все функции, находящиеся в текущем модуле, и также она '''будет иметь доступ''' к экспортированным переменным этого модуля. При использовании внешних переменных в отдельном потоке, нужно помнить, что система будет сначала искать по имени локальные переменные, потом экспортируемые переменные текущего модуля и только потом глобальные экспортированные переменные. Если имена переменных будут совпадать, может возникнуть конфликт и неочевидная ошибка.
 * В отличие от функции [[ExecuteFunction]], для аргументов функции не будет работать признак ''ByRef'', так как вызвавший поток не ожидает завершения выполнения функции и продолжает работать параллельно с новым.
 * Необработанные исключения внутри функции останавливают ее выполнение, но информация об этих исключениях будет поглощена и выведена в лог не будет (отладчик, однако, будет открыт в момент создания исключения, если режим отладки для визуального клиента разрешен).
-* Исполнение таких функций происходит быстрее, чем вызов новых модулей в отдельных потоках с помощью [[LoadModule]].
+* Исполнение таких функций происходит быстрее, чем вызов новых модулей в отдельных потоках с помощью [[LoadModule]], однако, открытые потоки завершаются при завершении основного потока, когда как потоки, открытые [[LoadModule]] независимы.
 == Синтаксис ==

← Older revision	Revision as of 10:10, 13 March 2022
(No difference)

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Функции общего назначения#Объект семафор|Семафор]]}}
-Функция инициирует исполнение функции с указанным именем в новом подчиненном потоке с заданными аргументами, способ поиска задается вторым аргументом. Если искомая функция не существует, пропущен обязательный аргумент или заданное количество аргументов слишком велико, будет создано исключение. Созданный поток будет автоматически завершен, если выполнение функции завершится (в т.ч. из-за необработанного исключения), либо если основной поток будет завершен. При завершении подчиненного потока, система не ждет полного окончания завершения, так как оно может занять продолжительное время, если функция выполняет внешний вызов OLE и пр., чтобы убедиться, что поток завершен, можно использовать функцию [[Mutex.TerminateThread|TerminateThread]]. Функция может быть вызвана для интерфейса Mutex. Некоторые важные свойства функций, исполняемых в отдельных потоках:
+Функция инициирует исполнение функции с указанным именем в новом подчиненном потоке с заданными аргументами, способ поиска задается вторым аргументом. Если искомая функция не существует, пропущен обязательный аргумент или заданное количество аргументов слишком велико, будет создано исключение. Созданный поток будет автоматически завершен, если выполнение функции завершится (в т.ч. из-за необработанного исключения), либо если основной поток будет завершен. При завершении подчиненного потока, система не ждет полного окончания завершения, так как оно может занять продолжительное время, если функция выполняет внешний вызов OLE и пр., чтобы убедиться, что поток завершен, можно использовать функцию [[Mutex.TerminateThread|TerminateThread]]. Для того, чтобы определить программно, происходит ли исполнение в режиме подчиненного потока, можно использовать функцию [[IsExecutingInSeparateThread]]. Функция может быть вызвана для интерфейса Mutex. Некоторые важные свойства функций, исполняемых в отдельных потоках:
 * Если создание такой функции инициировано корневым потоком, функция не будет завершена автоматически и будет находиться в памяти до тех пор, пока клиент не будет закрыт, либо программа не вызовет функцию [[Mutex.TerminateThread|TerminateThread]].
 * Исполняемая функция не обязательно должна быть корневой функцией текущего модуля, возможен, к примеру, вызов функции, подчиненной текущей функции, либо функции родительского или глобального модулей.

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

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