Admin: 1 revision imported

2026-04-01T09:57:50Z

1 revision imported

1>Admin: Created page with "{{infobox function |name=BroadcastChannelReceiveMessage |object=Функции общего назначения |caption=Доставка сообщений |type=1 |stat..."

2026-01-04T09:26:39Z

Created page with "{{infobox function |name=BroadcastChannelReceiveMessage |object=Функции общего назначения |caption=Доставка сообщений |type=1 |stat..."

New page

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

== Синтаксис ==
<code>
'''BroadcastChannelReceiveMessage'''(''<Имя или идентификатор канала (INT,STRING)>''{{Optional|,<Ожидать нового сообщения, мс. (INT)>{{Default|{{Eq}}0}}}}{{OptionalByRef|,<Код сообщения (INT)>,<Содержимое сообщения (STRING)>,<Отправитель (STRING)>}}):''<Получено новое сообщение (INT)>''
</code>
==== Аргументы ====
* <code>''<Имя или идентификатор канала (INT,STRING)>''</code> - Имя канала для подписки (строка) или его идентификатор (число).
* <code>''<Ожидать нового сообщения, мс. (INT)>''</code> - {{Optional}} Максимальное числов времени в мс., которое функция может провести в ожидении появления сообщение. При нуле (по умолчанию), функция возвращается без ожидания.
* <code>''<Код сообщения (INT)>''</code> - {{Optional}} {{ByRef}} Переменная, которая получит код сообщения, если сообщение было получено. Если сообщение не было получено, переменная изменена не будет.
* <code>''<Содержимое сообщения (STRING)>''</code> - {{Optional}} {{ByRef}} Переменная, которая получит текст сообщения, если сообщение было получено. Если сообщение не было получено, переменная изменена не будет.
* <code>''<Отправитель (STRING)>''</code> - {{Optional}} {{ByRef}} Переменная, которая получит идентификатор отправителя сообщения, если сообщение было получено. Если сообщение не было получено, переменная изменена не будет. Обычно отправитель состоит из номера канала клиента и идентификатора потока клиента.

==== Возвращаемое значение ====
Возвращает количество отосланных сообщений.

== Примеры ==
<pre>
//Пример простого отправителя и подписчика в одном фрагменте текста.

Function Подписчик()
аКодКанала:=BroadcastChannelSubscribe("Канал");
аНум:=0;
While 1 Do
If not BroadcastChannelReceiveMessage(аКодКанала,100,аНум) Then
Continue;
EndIf;
Message("Получено сообщение с ID "+аНум);
If аНум=100 Then
Break;
EndIf;
EndDo;
BroadcastChannelUnsubscribe(аКодКанала);
Message("Поток закончил работу...");
EndFunction

Mutex.ExecuteFunctionInSeparateThread("Подписчик",0);

аКодКанала:=BroadcastChannelSubscribe("Канал");
ИдСообщения:=1;
While ИдСообщения<=100 Do
If BroadcastChannelSendMessage(аКодКанала,ИдСообщения,"")>0 Then
ИдСообщения:=ИдСообщения+1;
EndIf;
EndDo;
//Ожидания завершения потока после принятия сообщения 100
//Без этой паузы, поток можен быть завершен форсировано, так как текущий (родительский) поток будет завершен
Sleep(1000);

//Будет выведено:
//Получено сообщение с ID 1
//Получено сообщение с ID 2
//..
//Получено сообщение с ID 100
//Поток закончил работу...
</pre>

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

BroadcastChannelReceiveMessage - Revision history

Admin: 1 revision imported

1>Admin: Created page with "{{infobox function |name=BroadcastChannelReceiveMessage |object=Функции общего назначения |caption=Доставка сообщений |type=1 |stat..."