Admin: 1 revision imported

2026-04-01T09:57:50Z

1 revision imported

1>Admin at 09:30, 4 January 2026

2026-01-04T09:30:10Z

New page

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

== Синтаксис ==
<code>
'''BroadcastChannelSendMessage'''(''<Имя или идентификатор канала (INT,STRING)>'',''<Код сообщения (INT)>'',''<Содержимое сообщения (STRING)>''):''<Количество отосланных сообщений (INT)>''
</code>
==== Аргументы ====
* <code>''<Имя или идентификатор канала (INT,STRING)>''</code> - Имя канала для подписки (строка) или его идентификатор (число).
* <code>''<Код сообщения (INT)>''</code> - Произвольный код сообщения, коды 1-10000 рекомендуется использовать для нужд проекта, остальные для нужд внешних обработок.
* <code>''<Содержимое сообщения (STRING)>''</code> - Произвольный текст сообщения для отправки (строка может содержать международные и любые непечатные символы).

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

== Примеры ==
<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)

BroadcastChannelSendMessage - Revision history

Admin: 1 revision imported

1>Admin at 09:30, 4 January 2026