SunFlurry wiki - Recent changes [en]

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

== Синтаксис ==
<code>
{{Grey|TempDB.}}'''Update'''({{Optional|<Источник данных (STRING,TEMPDB)>}},''<Формулы для вычисления столбцов (STRING)>''{{Optional|,<Стандартные фильтры>...}})
</code>

==== Аргументы ====
* <code>''<Источник данных (DB,STRING,TEMPDB)>''</code> - {{Optional}} Источник данных для получения дополнительной информации для изменения столбцов таблицы. Параметр необязателен, если он является другой временной таблицей базы данных, также необходимо указать дополнительное условие связи между записями текущей временной таблицы и записями или элементами объекта базы данных (см. второй аргумент). Источником может быть:
** '''Строка''' -- задает путь объекта базы данных и наименование столбца, по которому будет происходить синхронизация между объектом и текущей таблицей в виде <code><Тип данных БД>.<Вид данных БД>:<Столбец, содержащий объекты указанного вида></code>.
** '''Другая временная таблица базы данных''' -- переменная, задающая другую временную или постоянную таблицу базы данных (даже из другой внешней БД).
* <code>''<Формулы для вычисления столбцов (STRING)>''</code> - Аргумент задает способ вычисления столбцов таблицы, формулы могут использовать столбцы самой таблицы при вычислении, а также, если указан дополнительный источник данных, информацию из него. Задание аргумента имеет следующий формат: <code>[<Условие объединения записей текущей таблицы и записей другой временной таблицы-источника данных>,]<Выражение 1>-><Имя столбца 1>,<Выражение 2>-><Имя столбца 2>...</code>. Выражения содержат весь возможный набор функций и операторов языка запросов (см. [[Временная таблица базы данных]], [[Объект запрос базы данных]]). '''Важно''': Не все серверы базы данных готовы принимать выражения с использованием ссылок на поля внешних таблиц (<code>Doc.DocDate</code> и т.п.) в условие ''объединения и записей текущей таблицы и записей другой временной таблицы-источника данных''. Это ограничение можно обойти, предварительно создав дополнительный столбец в оригинальной таблице и заполнив его результатом выражения, с тем, чтобы в условии были только простые указания на столбцы. См. пример, демонстрирующий такую проблему ниже. Также для этого условия рекомендуется использовать наиболее простые выражения без вычислений. SQLite3, к примеру, очень сильно замедляет выполнение запроса, если в условии для объединения использованы какие-либо вычисления.
* <code>''<Стандартные фильтры>''</code> - {{Optional}} Стандартные фильтры отбора записей текущей таблицы данных описаны в статье [[Стандартные фильтры]]. Важное отличие от фильтров функций объектов базы данных заключается в том, что стандартные фильтры всегда работают в сложном (расширенном) режиме, при этом отсутствует требование, что первая строка фильтра должна начинаться на знак '''~'''. Выражения фильтров содержат весь возможный набор функций и операторов языка запросов (см. [[Временная таблица базы данных]], [[Объект запрос базы данных]]), при указании наименование также применимы префиксы (типа ''':'''), как это описано в [[Временная таблица базы данных#Формулы при вычислении полей записей временной таблицы базы данных|статье по временной таблице базы данных]]. Записи таблицы, не входящие в фильтр, будут пропущены при изменении.

== Примеры ==
<pre>
//Пример создает таблицу аТемп, и заполняет ее резервами документа ЗаказНаПроизводство, при этом в ней также заполнено поле документа ВыпускПродукции.
// Документ ВыпускПродукции подчинен документу ЗаказНаПроизводство. Выборка документов происходит за период с НачДата по КонДата.
//Таблица номенклатуры из резервов с выпусками и заданиями
аТемп:=TempDB.Create("зДок:DB,зЗад:DB,зН:DB:I,Количество:NUMBER.15.5");
//Заказы на производство
аТемп.LoadFrom("Stor.Резервы","@LINK->зЗад,Номенклатура->зН,?(@EXPENSE=1,-Количество,Количество)->Количество",
"(BegOfDay(@DATE)>=НачДата)And(BegOfDay(@DATE)<=КонДата)","IsType(@LINK,Doc.ЗаказНаПроизводство)");
//Заполняем зДок (подчиненный документ -- ВыпускПродукции)
вТемп:=TempDB.Create("зДок2:DB,зЗад:DB");
//Выбираются только те документы выпусков, основания которых (ЗаказНаПроизводство) находятся в таблице аТемп
вТемп.LoadFrom("Doc.ВыпускПродукции","@ELEMENT->зДок2,@ELEMENT.ДокОснование->зЗад","@ELEMENT.ДокОснование IN аТемп.зЗад");
//Заполним столбец зДок оригинальной таблицы, объединение происходит по условию ":зЗад=зЗад".
аТемп.Update(вТемп,":зЗад=зЗад,зДок2->зДок");
//В дальнейшем таблицу аТемп можно выводить на экран или использовать в последующих запросах.
</pre>

<pre>
//Второй пример показывает последовательное заполнение реквизитов Контрагент (зК), Адрес (зАД) и Дата документа (зДата) из разных объектов базы данных в таблицу,
// которая содержит совокупность строк, загруженных из накопителя
//Создаем и заполняем таблицу движениями накопителя Остатки, накопитель не содержит всех необходимых нам полей, к примеру, в нем отсутствует указание на контрагента или адрес
аСтроки:=TempDB.Create("зДал:Number.20.7,зН:DB,зПартия:DB,зК:DB,зАД:DB,зДок:DOC,зСклад:DB,зДата:Date");
//Запрос производится за период с НачДата по КонДата, также отбирается номенклатура по спискам оН.Get(1) и оН.Get(2)
аСтроки.LoadFrom("Storage.Остатки","Количество*?(@EXPENSE=0,1,-1)*Номенклатура.Объем->зДал,Номенклатура->зН,Склад->зСклад,Партия->зПартия,@LINK->зДок","@DATE>=НачДата","@Date<КонДата",
"Номенклатура IN оН.Get(1)","Номенклатура NOT IN оН.Get(2)");

//Удаляем из таблицы строки, связанные с документами, типа Сторнирование
аСтроки.Remove("IsType(зДок,Doc.Сторнирование)");

//Заполняем столбцы Контрагент, Адрес и Дата, так как накопитель может иметь записи разных документов, которые являются разными таблицами БД,
// необходимо делать запросы отдельно по каждой из таблицы, альтернативно, можно было бы сделать запрос к какому-нибудь журналу документов,
// если последний содержит нужные поля.
//Запросы выглядят одинаковыми, но они происходят к разным таблицам и разным реквизитам (столбцам) таблиц
// Те записи текущей таблицы, которые отсутствуют в источнике данных, по которому происходит запрос, будут пропущены при обновлении
аСтроки.Update("Doc.Реализация:зДок","Контрагент->зК,Адрес->зАД,DocDate->зДата");
аСтроки.Update("Doc.ВозвратПоставщику:зДок","Контрагент->зК,Адрес->зАД,DocDate->зДата");
аСтроки.Update("Doc.ВозвратОтПокупателя:зДок","Контрагент->зК,Адрес->зАД,DocDate->зДата");
аСтроки.Update("Doc.ПоступлениеТМЦ:зДок","Контрагент->зК,Адрес->зАД,DocDate->зДата");
</pre>

<pre>
//Пример показывает ограничения при использовании функции и обновлении содержимого таблицы с помощью другой таблицы базы данных, когда объединение производится с помощью сложного выражения.
//Таблицы:
//аТемп содержит столбцы зДок (документ ВыпускПродукции) и зН (справочник Номенклатура), Количество (вещественное число)
//бТемп содержит столбцы Index (составной столбец, полученный по формуле зДок.DocNum+":"+GetYear(зДок.DocDate)+":"+зН.Code), Цена (цена материала зН в документе ВыпускПродукции зДок)
//Требуется добавить и заполнить столбец "Сумма" в таблице аТемп используя столбик локальный Количество и столбик Цена из бТемп.

//Данная конструкция не будет работать под MS-SQL, так как при объединении таблиц не разрешается использование переменных из внешних таблиц
// (однако, конструкция, возможно будет работать под управлением других типов СУБД):

аТемп.AddColumns("Сумма:Number.15.2");
аТемп.Update(бТемп,"Trim(:зДок..Doc.ВыпускПродукции.DocNum)+"":""+Str(GetYear(:зДок..Doc.ВыпускПродукции.DocDate))+"":""+:зН..Ref.тмцНоменклатура.Code=Index,Цена*:Количество->Сумма");

//Данная конструкция будет работать корректно (заметьте, что локальные столбцы помечаются префиксом ":", чтобы избежать разночтения системой):

аТемп.AddColumns("Сумма:Number.15.2,Index:STRING.100");
аТемп.Update(,"Trim(зДок..Doc.ВыпускПродукции.DocNum)+"":""+Str(GetYear(зДок..Doc.ВыпускПродукции.DocDate))+"":""+зН..Ref.тмцНоменклатура.Code->Index");
аТемп.Update(бТемп,":Index=Index,Цена*:Количество->Сумма");
</pre>

TempDB.Create

Admin — Wed, 01 Apr 2026 10:00:50 GMT

Admin imported TempDB.Create by file upload (1 revision)

New page

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

== Синтаксис ==
<code>
{{Grey|TempDB.}}'''Create'''({{Optional|<Наименования столбцов с типами данных (STRING)>,<Имя внешней БД и наименование ее таблицы (STRING)>}}):''<Новый объект (TEMPDB)>''
</code>

==== Аргументы ====
* <code>''<Наименования столбцов с типами данных (STRING)>''</code> - {{Optional}} Задает наименования столбцов в создаваемой таблице через запятую, формат задания столбца: <code><Наименование столбца>:<Тип данных столбца>[:<Дополнительные флаги столбца>]</code>.
** Наименование столбца подчиняется стандартным правилам создания наименований в системе и может содержать международные символы.
** [[Нотация типов данных|Тип данных]] задается либо в виде прямого указания на тип данных <code><Тип>[.<Размер>[.<Точность>]]</code>, возможно указание на следующие типы:
*** '''NUMBER''', '''NUM''' -- задает вещественное число с указанием на точность его представления. Тип записывается в виде <code>NUMBER.<Общее количество цифр>.<Количество цифр после точки></code>.
*** '''INTEGER''', '''INT''' -- задает целое 64-битное число.
*** '''REAL''' -- задает произвольное вещественное число (в инженерной нотации)
*** '''DATE''' -- задает тип данных даты и времени.
*** '''STRING''', '''STR''' -- задает строковой тип данных с указанием длины строки в виде <code>STRING.<Длина строки в символах></code>. Для строк произвольной длины, необходимо указать ноль (возможности при работе с такими строками имеют определенные ограничения для SQL серверов).
*** '''ANY''', '''DB''' -- задает произвольный тип базы данных.
*** '''<Тип данных БД>[.<Вид данных БД>]''' -- задает определенный тип данных базы данных. В ''типе данных БД'' можно указать '''REF''', '''DOC''', '''JOUR''', '''STOR''' или '''ENUM'''.
** Также ''тип данных'' можно задать с помощью указания на существующий реквизит объекта базы данных, иногда такой способ является более универсальным. В это случае формат записи выглядит следующим образом: <code>-><Тип данных БД>.<Вид данных БД>.<Реквизит объекта БД></code>. Система автоматически использует тип данных указанного реквизита для создания столбца временной таблицы.
** ''Флаги столбца'' представляют совокупность букв-указаний. В данный момент можно использовать следующие указания:
*** '''I''' -- Добавить индекс к данному столбцу после создания
*** '''U''' -- Текстовые данные, хранящиеся в столбце будут использовать формат UTF-16. '''Внимание''': без такого указания, по умолчанию текст будет храниться в текущей кодировке ANSI, что может явиться причиной потери международных символов.
* <code>''<Имя внешней БД и наименование ее таблицы (STRING)>''</code> - {{Optional}} При использовании этого аргумента будет создана, модифицирована или проверена постоянная таблица БД с указанным именем в указанной базе данных СУБД. Аргмент задается в формате <code><Имя базы данных>.<Имя временной таблицы></code>. Имена баз данных должны быть заранее заданы в [[Установки сервера|установках сервера]] (ветка '''SimpleDBases'''), имена таблиц могут быть произвольными, однако рекомендуется использовать только латиницу и цифры, запрещено использовать знаки "." или ",". Объект, созданный в этом режиме, будет функционально соответствовать обычному объекту временной таблицы БД, однако, на данный момент функция [[TempDB.Group|Group]] недоступна для таких таблиц, и функция удаления таблицы [[TempDB.DeleteTable|DeleteTable]] будет работать только для них.

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

== Примеры ==
<pre>
//Пример создает таблицу аТемп, и заполняет ее резервами документа ЗаказНаПроизводство, при этом в ней также заполнено поле документа ВыпускПродукции.
// Документ ВыпускПродукции подчинен документу ЗаказНаПроизводство. Выборка документов происходит за период с НачДата по КонДата.
//Таблица номенклатуры из резервов с выпусками и заданиями
аТемп:=TempDB.Create("зДок:DB,зЗад:DB,зН:DB:I,Количество:NUMBER.15.5");
//Заказы на производство
аТемп.LoadFrom("Stor.Резервы","@LINK->зЗад,Номенклатура->зН,?(@EXPENSE=1,-Количество,Количество)->Количество",
"(BegOfDay(@DATE)>=НачДата)And(BegOfDay(@DATE)<=КонДата)","IsType(@LINK,Doc.ЗаказНаПроизводство)");
//Заполняем зДок (подчиненный документ -- ВыпускПродукции)
вТемп:=TempDB.Create("зДок2:DB,зЗад:DB");
//Выбираются только те документы выпусков, основания которых (ЗаказНаПроизводство) находятся в таблице аТемп
вТемп.LoadFrom("Doc.ВыпускПродукции","@ELEMENT->зДок2,@ELEMENT.ДокОснование->зЗад","@ELEMENT.ДокОснование IN аТемп.зЗад");
//Заполним столбец зДок оригинальной таблицы, объединение происходит по условию ":зЗад=зЗад".
аТемп.Update(вТемп,":зЗад=зЗад,зДок2->зДок");
//В дальнейшем таблицу аТемп можно выводить на экран или использовать в последующих запросах.
</pre>

TempDB.DeleteTable

Admin — Wed, 01 Apr 2026 10:00:50 GMT

Admin imported TempDB.DeleteTable by file upload (1 revision)

New page

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

== Синтаксис ==
<code>
{{Grey|TempDB.}}'''DeleteTable'''(''<Имя внешней БД и наименование ее таблицы (STRING)>'')
</code>

==== Аргументы ====
* <code>''<Имя внешней БД и наименование ее таблицы (STRING)>''</code> - Аргмент задается в формате <code><Имя базы данных>.<Имя временной таблицы></code>. Имена баз данных должны быть заранее заданы в [[Установки сервера|установках сервера]] (ветка '''SimpleDBases'''), имена таблиц могут быть произвольными.

== Примеры ==
<pre>
//Создание или открытие постоянной таблицы "table1" в базе данных DBExport
аТемп:=TempDB.Create("зДок:DB,зЗад:DB,зН:DB:I,Количество:NUMBER.15.5","DBExport.table1");

//Удаление постоянной таблицы "table2" из базы данных DBExport. Если она не существовала, никаких действий выполнено не будет.
TempDB.DeleteTable("DBExport.table2");
</pre>

TempDB.Group

Admin — Wed, 01 Apr 2026 10:00:50 GMT

Admin imported TempDB.Group by file upload (1 revision)

New page

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

== Синтаксис ==
<code>
{{Grey|TempDB.}}'''Group'''({{Optional|<Столбцы группировки (STRING)>,<Столбцы агрегации с операциями (STRING)>}})
</code>

==== Аргументы ====
* <code>''<Столбцы группировки (STRING)>''</code> - {{Optional}} Аргумент перечисляет через запятую наименования столбцов, по которым будет группироваться таблица. Регистр наименований не имеет значения. Каждый заданный столбец должен присутствовать во временной таблице.
* <code>''<Столбцы агрегации с операциями (STRING)>''</code> - {{Optional}} Аргумент перечисляет наименования столбцов через запятую, для которых будет выполнена заданная операция агрегации. Регистр наименований не имеет значения. Каждый заданный столбец должен присутствовать в таблице. Формат записи выглядит сл. образом: <code><Столбец1[:<Операция1>][,<Столбец2[:<Операция2>]...]></code>. Функция позволяет использовать следующие операции:
** '''SUM''' (по умолчанию) -- значения столбца для удаляемых строк и оставшихся строк будут найдены суммированием.
** '''AVG''' -- Будут найдены средние значения столбца для удаляемых строк и оставшихся строк.
** '''MAX''' -- В столбцах оставшихся строках будет содержаться максимальное из значение удаляемых строк и оставшихся.
** '''MIN''' -- В столбцах оставшихся строках будет содержаться минимальное из значение удаляемых строк и оставшихся.
** '''COUNT''' -- В столбцах оставшихся строках будет содержаться количество удаленных строк этой группировки, увеличенное на единицу.

== Примеры ==
<pre>
//Пример создает таблицу аТемп, и заполняет ее резервами реализациями договора аДоговор с помощью загрузки движений накопителя Взаиморасчеты
// При этом суммы подчиненных документов возврата отнимаются от сумм документов реализации
//После создания, производится выборка записей по датам документов реализации
аТемп:=TempDB.Create("аДок:DB,Сумма:NUMBER.15.2");
аТемп.LoadFrom("Stor.Взаиморасчеты","@LINK->аДок,Сумма*?(@EXPENSE=1,-1,1)->Сумма","Договор=аДоговор","isEmpty(Тара)","IsType(@LINK,Doc.Реализация,Doc.ВозвратОтПокупателя)");
//Для документов возврата подставляем в столбик аДок их основание
аТемп.Update(,"аДок..Doc.ВозвратОтПокупателя.ДокОснование->аДок","IsType(аДок,Doc.ВозвратОтПокупателя)");
аТемп.Group("аДок","Сумма");
аТемп.Remove("(Сумма<=0)Or(Not isType(аДок,Doc.Реализация))");
аТемп.AddColumns("Дата:DATE");
аТемп.Update(,"аДок..Doc.Реализация.DocDate->Дата");
аТемп.Select("Дата-");
...
</pre>

TempDB.LoadFrom

Admin — Wed, 01 Apr 2026 10:00:50 GMT

Admin imported TempDB.LoadFrom by file upload (1 revision)

New page

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

== Синтаксис ==
<code>
{{Grey|TempDB.}}'''LoadFrom'''(''<Источник данных (DB,STRING,TEMPDB)>'',''<Формулы для вычисления столбцов (STRING)>''{{Optional|,<Стандартные фильтры>...}})
</code>

==== Аргументы ====
* <code>''<Источник данных (DB,STRING,TEMPDB)>''</code> - Источник данных для добавления записей может быть:
** '''Объект базы данных''' -- принимаются объекты типа Справочник, Документ, Накопитель или Журнал.
** '''Строка''' -- задает путь объекта базы данных в виде <code><Тип данных БД>.<Вид данных БД></code>.
** '''Другая временная таблица базы данных''' -- переменная, задающая другую временную или постоянную таблицу базы данных, записи которой будут копироваться в данную. Постоянная таблица может принадлежать другой внешней БД.
* <code>''<Формулы для вычисления столбцов (STRING)>''</code> - Аргумент задает способ вычисления столбцов текущей таблицы при добавлении записей из источника. Столбцы, не указанные в данном аргументе, при добавлении новой записи, будут заполнены пустыми значениями по умолчанию. Задание аргумента имеет следующий формат: <code>[Aggregate[:<Столбцы группировки через ":">],]<Выражение 1>-><Имя столбца 1>,<Выражение 2>-><Имя столбца 2>...</code>. При наличии зарезервированного слова ''Aggregate'' к источнику данных будет создан запрос агрегации с группировкой по указанным столбцам таблицы или реквизитам объекта {{Planned}}, при этом в выражениях для вычисления можно использовать функции агрегации. Выражения содержат весь возможный набор функций и операторов языка запросов (см. [[Временная таблица базы данных]], [[Объект запрос базы данных]]).
* <code>''<Стандартные фильтры>''</code> - {{Optional}} Стандартные фильтры отбора записей источника данных описаны в статье [[Стандартные фильтры]]. Важное отличие от фильтров функций объектов базы данных заключается в том, что стандартные фильтры всегда работают в сложном (расширенном) режиме, при этом отсутствует требование, что первая строка фильтра должна начинаться на знак '''~'''. Выражения фильтров содержат весь возможный набор функций и операторов языка запросов (см. [[Временная таблица базы данных]], [[Объект запрос базы данных]]), при указании наименование также применимы префиксы (типа ''':'''), как это описано в [[Временная таблица базы данных#Формулы при вычислении полей записей временной таблицы базы данных|статье по временной таблице базы данных]].

== Примеры ==
<pre>
//Пример создает таблицу аТемп, и заполняет ее резервами документа ЗаказНаПроизводство, при этом в ней также заполнено поле документа ВыпускПродукции.
// Документ ВыпускПродукции подчинен документу ЗаказНаПроизводство. Выборка документов происходит за период с НачДата по КонДата.
//Таблица номенклатуры из резервов с выпусками и заданиями
аТемп:=TempDB.Create("зДок:DB,зЗад:DB,зН:DB:I,Количество:NUMBER.15.5");
//Заказы на производство
аТемп.LoadFrom("Stor.Резервы","@LINK->зЗад,Номенклатура->зН,?(@EXPENSE=1,-Количество,Количество)->Количество",
"(BegOfDay(@DATE)>=НачДата)And(BegOfDay(@DATE)<=КонДата)","IsType(@LINK,Doc.ЗаказНаПроизводство)");
//Заполняем зДок (подчиненный документ -- ВыпускПродукции)
вТемп:=TempDB.Create("зДок2:DB,зЗад:DB");
//Выбираются только те документы выпусков, основания которых (ЗаказНаПроизводство) находятся в таблице аТемп
вТемп.LoadFrom("Doc.ВыпускПродукции","@ELEMENT->зДок2,@ELEMENT.ДокОснование->зЗад","@ELEMENT.ДокОснование IN аТемп.зЗад");
//Заполним столбец зДок оригинальной таблицы, объединение происходит по условию ":зЗад=зЗад".
аТемп.Update(вТемп,":зЗад=зЗад,зДок2->зДок");
//В дальнейшем таблицу аТемп можно выводить на экран или использовать в последующих запросах.
</pre>

TempDB.Copy

Admin — Wed, 01 Apr 2026 10:00:49 GMT

Admin imported TempDB.Copy by file upload (1 revision)

New page

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

== Синтаксис ==
<code>
{{Grey|TempDB.}}'''Copy'''():''<Копия ссылки на внешнюю БД (TEMPDB)>''
</code>

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

== Примеры ==
<pre>
//Создание или открытие постоянной таблицы "table1" в базе данных DBExport
аТемп:=TempDB.Create("зДок:DB,зЗад:DB,зН:DB:I,Количество:NUMBER.15.5","DBExport.table1");

//Создадим копию объекта
аТемп2:=аТемп.Copy();
</pre>

Table.RenderToPicture

Admin — Wed, 01 Apr 2026 10:00:48 GMT

Admin imported Table.RenderToPicture by file upload (1 revision)

New page

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

== Синтаксис ==
<code>
{{Grey|Table.}}'''RenderToPicture'''(''<Список с настройками для создания рисунков (LIST)>''):''<Картинки в формате BMP (LIST)>''
</code>

==== Аргументы ====
* <code>''<Список с настройками для создания рисунков (LIST)>''</code> - Список содержит настройки, наименованиями служат перечисленные ниже наименования настроек, значениями -- их значения.
** '''PaperWidth''', '''Width''' -- настройка задает ширину картинок в точках. Настройка должна обязательно присутствовать.
** '''PaperHeight''', '''Height''' -- настройка задает высоту картинок в точках. Настройка должна обязательно присутствовать.
** '''BPP''' -- настройка задает глубину цвета в создаваемых картинках. По умолчанию '''16'''. Разрешено использовать значения: 8, 16, 24 и 32.
** '''FromPage''', '''ToPage''' -- настройки задают начальную и конечную страницу таблицы для превращения в картинки. По умолчанию превращать все страницы.
** '''DPI''' -- настройка задают плотность точек на бумаге (Dots per inch), которая используется только для определения размеров полей страницы, так как поля задаются в миллиметрах, а не в точках. По умолчанию этот параметр задается как '''300'''. Также часто используются значения ''72'', ''150'', ''600'', но значение может быть любым. Используя это значение размер поля будет вычисляться по формуле <code><Поле в мм>/25.4*<dpi></code>.

==== Возвращаемое значение ====
Функция возвращает список с некоторым числом объектов типа картинка.

== Примеры ==
<pre>
пТекст:="Текст для поле в таблице";
Т:=Table.Create();
Т.SetSourceName("Modules\FreeForms\СвободныеТаблицы\ТекстНаЭтикетке");

Т.CopyByX("v31",1);
Т.Area(1,1).WrappingMode:=1;
Т.Printing.Fields.Up:=0;
Т.Printing.Fields.Down:=0;
Т.Printing.Fields.Left:=0;
Т.Printing.Fields.Right:=0;
Т.Printing.Titles.Up.Size:=0;
Т.Printing.Titles.Down.Size:=0;
Т.Printing.PageOptions:=_PRN_PAGE_CENTERX+_PRN_PAGE_CENTERY;
Т.Printing.ScaleMode:=3;

//Параметры превращения в картинку
aList:=List.Create();
//Размеры в точках
aList["Width"]:=600;
aList["Height"]:=200;
//Глубина цвета (16 бит)
aList["BPP"]:=16;

//Должна получиться всего одна картинка
bList:=Т.RenderToPicture(aList);
//Сохраним в файл без изменения формата
bList[1].Save("c:\picture.bmp","bmp");
</pre>

Tab.Copy

Admin — Wed, 01 Apr 2026 10:00:24 GMT

Admin imported Tab.Copy by file upload (1 revision)

New page

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

== Синтаксис ==
<code>
{{Grey|Tab.}}'''Copy'''({{Optional|<Только создать столбцы (INT)>{{Default|{{Eq}}0}}}}):''<Новая таблица (TAB)>''
</code>

==== Аргументы ====
* <code>''<Только создать столбцы (INT)>''</code> - {{Optional}} Если аргумент задан и равен ''1'', будет скопирована только структура столбцов таблицы, строки и значения скопированы не будут.

==== Возвращаемое значение ====
Возвращается таблица, полностью соответствующая текущей, однако, являющаяся новым объектом.

== Примеры ==
<pre>
//Создается и заполняется таблица значений
aTab:=Tab.Create("b1,b2,b3,b4");

aTab.AddLine("b1,b2,b3,b4",1,2,3,4);
aTab.AddLine("b1,b2,b3,b4",2,2,3,33);
aTab.AddLine("b1,b2,b3,b4",3,5,5,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,77);
aTab.AddLine("b1,b2,b3,b4",5,2,3,4);

//Создается копия таблицы, новый объект.
bTab:=aTab.Copy();
//Таблица bTab группируется по столбцам b2 и b3, оригинальная таблица aTab не изменяется
bTab.Group("b2,b3","b1,b4");

Message("Таблица aTab:");
aTab.Select();
While aTab.Next() Do
Message(""+aTab.b1+"; "+aTab.b2+"; "+aTab.b3+"; "+aTab.b4);
EndDo;

Message("Таблица bTab:");
bTab.Select();
While bTab.Next() Do
Message(""+bTab.b1+"; "+bTab.b2+"; "+bTab.b3+"; "+bTab.b4);
EndDo;

//Будет выведено последовательно:
//"Таблица aTab:"
//"1; 2; 3; 4"
//"2; 2; 3; 33"
//"3; 5; 5; 4"
//"4; 2; 3; 4"
//"4; 2; 3; 77"
//"5; 2; 3; 4"
//"Таблица bTab:"
//"16; 2; 3; 122"
//"3; 5; 5; 4"
</pre>

Mutex.ExecuteFunctionInSeparateThread

Admin — Wed, 01 Apr 2026 09:59:36 GMT

Admin imported Mutex.ExecuteFunctionInSeparateThread by file upload (1 revision)

New page

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

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

Lib.CreateCallbackFunction

Admin — Wed, 01 Apr 2026 09:59:32 GMT

Admin imported Lib.CreateCallbackFunction by file upload (1 revision)

New page

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

== Синтаксис ==
<code>
{{Grey|Lib.}}'''CreateCallbackFunction'''(''<Имя функции (STRING)>''{{Optional|,<Глубина поиска (INT)>{{Default|{{Eq}}0}},<Способ вызова (STRING)>{{Default|{{Eq}}"Stdcall"}},<Аргументы функции (STRING)>,<Возвращаемое значение (STRING)>}}):''<Новый объект функции обратного вызова (CBFUNCTION)>''
</code>
==== Аргументы ====
* <code>''<Имя функции (STRING)>''</code> - Аргумент задает имя локальной или глобальной функции, которой будет передано управление в момент внешнего вызова системной функции, задаваемой своим адресом.
* <code>''<Глубина поиска (INT)>''</code> - {{Optional}} Задает способ поиска локальной функции. Может принимать следующие значения:
** -1 -- выполнять поиск по последовательности функций из стека вызовов, а не искать, используя подчинение функций на момент компиляции. Этот способ предпочтительнее использовать в компилированных функциях, вызываемых из разных мест модуля или из разных модулей, чтобы получить доступ к реальной среде функций, а не к оной на момент компиляции.
** 0 (по умолчанию) -- выполнять поиск во всех модулях [[Общее описание языка#Вложенность функций и модулей, уровни вложенности|большего уровня вложенности]] (родительских) и во всех глобальных модулях.
** 1 -- выполнять поиск только внутри текущего модуля.
** 2 -- выполнять поиск только внутри родительского модуля.
** 3..x -- выполнять поиск только внутри родительского модуля указанного уровня (к примеру, для уровня 3, выполнять поиск только в родителе родителя текущего модуля).
* <code>''<Способ вызова (STRING)>''</code> - {{Optional}} Аргумент задает способ вызова функции системной функции снешним источником (см. [[Объект загружаемой системной библиотеки|статью]] для дополнительной информации). Возможны следующие значения аргумента:
** '''stdcall''' (x86,x64) -- стандартный способ вызова функций Windows, используется по умолчанию. Для x64 является единственным доступным способом вызова.
** '''cdecl''' (x86) -- используется при вызове из среды, скомпилированной с помощью C или C++.
** '''fastcall''' (x86) -- используется при вызове из среды, скомпилированной с помощью C или C++, когда вызываемая функция там помечена, как fastcall.
** '''register''' (x86) -- используется при вызове из функций, скомпилированных с помощью Delphi или Free Pascal. Важно понимать, что, возможно, придется пометить некоторые параметры при вызове таких функций с помощью префикса "+" (см. ниже).
** '''vectorcall''' (x86,x64) -- способ вызова, оперирующий длинными числами (128 бит), в данный момент не поддерживается.
* <code>''<Аргументы функции (STRING)>''</code> - {{Optional}} Задает список и тип аргументов, передаваемых функции. Строка имеет следующий формат: <code><Аргумент 1>,<Аргумент 2>,...</code>. Где ''аргумент'' имеет следующий формат: <code>[<Префиксы типа данных>]<Тип данных аргумента>[<Размер типа данных>]</code>. Далее даются все возможные префиксы и наименования типов данных:
** '''^''' (префикс) -- определяет то, что аргумент будет являться ссылкой (указателем, ''pointer'') на данные, а не самими данными.
** '''^^''' (префикс) -- определяет то, что аргумент будет являться ссылкой (указатель, ''pointer'') на ссылку на данные, а не самими данными. Префикс можно эмулировать с помощью манипуляции с буфером данных.
** '''@''' (префикс) -- определяет то, что аргумент будет являться ссылкой (указателем, ''pointer'') на данные, а не самими данными. Также помечает аргументы "by ref", т.е., аргументы, значение которых может быть изменено функцией и должно быть передано назад в вызывавшую программу. '''Важно''': без этого префикса, измененные функцией значения не будут переданы назад, даже если аргумент локальной функции имеет префикс ''ByRef''. Префикс может дополняться префиксом ''^'', если необходимо.
** '''U''' (префикс) -- используется для типов ''I'' или ''N'', указывает на то, что данные представляют собой беззнаковое число (по умолчанию число со знаком)
** '''+''' (префикс) -- определяет то, что данный аргумент всегда будет передаваться в стек, а не с помощью регистра процессора. Флаг имеет значение только для способа вызова функции ''register''. Для его использования необходимо полностью понимать, как работает вызов функции (calling convention) такого типа. Обычно нет необходимости в использовании этого префикса, система сама правильно определит какие аргументы будут передаваться в стек, а какие с помощью регистров.
** '''I<Размер в битах>''' или '''Int<Размер в битах>''' (наименование типа данных) -- задает целый тип аргумента. Размер может принимать следующие значения: '''8''', '''16''', '''32''', '''64'''.
** '''N''' или '''Native''' (наименование типа данных) -- задает целый тип аргумента с размером, задаваемым текущей архитектурой исполнения приложения. Для ''x86'' длина поля будет представлять 32 бита, для ''x64'' -- 64 бита.
** '''R<Размер в битах>''' или '''Real<Размер в битах>''' (наименование типа данных) -- задает вещественный тип аргумента. Размер может принимать следующие значения: '''32''' (одинарная точность), '''64''' (двойная точность), '''80''' (расширенная точность). Расширенная точность не поддерживается при стандартных вызовах "x64" функций, при написании расширения программы, можно пользоваться, к примеру, ссылкой на вещественное число ('''P''') и получение его из буфера.
** '''B<Размер в битах>''' или '''Bool<Размер в битах>''' (наименование типа данных) -- задает булевый тип аргумента. Размер может принимать следующие значения: '''8''', '''16''', '''32''', '''64'''.
** '''P''' или '''Pointer''' (наименование типа данных) -- задает тип данных указателя на данные. Для ''x86'' длина поля будет поставлять 32 бита, для ''x64'' -- 64 бита. При вызове функцией в аргументах такого типа удобно возвращать объекты буфера или записи.
** '''SZ<Размер в байтах>''' или '''SZW<Размер в словах>''' (наименование типа данных) -- задает аргумент с типом строка, заканчивающаяся нулевым символом. Строка может иметь формат ANSI (''SZ'') или UTF-16 (''SZW''). Строки всегда должны быть объявлены с префиксом ''^'' (ссылка на данные). Размер может принимать нулевое значение, если заранее неизвестно, строка какого размера будет использоваться. В случае нулевого размера, однако, при подготовке аргумента, размер будет выделен точно под строку. Кроме строковых значений, система принимает также буферы или записи (для которых вызов выполняется несколько быстрее, чем для строк).
** '''S<Размер в байтах>''' или '''SW<Размер в словах>''' (наименование типа данных) -- задает аргумент с типом строка фиксированной длины. Строка может иметь формат ANSI (''S'') или UTF-16 (''SW''). Строки всегда должны быть объявлены с префиксом ''^'' (ссылка на данные). Размер может принимать нулевое значение, если заранее неизвестно, строка какого размера будет использоваться. В случае нулевого размера, однако, при подготовке аргумента, размер будет выделен точно под строку. Кроме строковых значений, система принимает также буферы (для которых вызов выполняется несколько быстрее, чем для строк).
* <code>''<Возвращаемое значение (STRING)>''</code> - {{Optional}} Имеет формат одного аргумента функции (см. выше), если аргумент опущен, возвращаемое функцией значение будет игнорировано (функция не возвращает значения).

==== Возвращаемое значение ====
Возвращается новый объект функции обратного вызова.

== Примеры ==
<pre>
//Пример производит вывод на экран заголовков и наименований классов всех видимых верхних окон системы.
Var aUser32 Export;

Function EnumWindowsProc(hwnd,LParam)
If aUser32.IsWindowVisible(hwnd) Then
СтрИмя:="";
aUser32.GetWindowText(hwnd,СтрИмя,4095);
СтрКласс:="";
aUser32.GetClassName(hwnd,СтрКласс,4095);
Message(""+hwnd+":"+СтрКласс+?(СтрИмя<>"","("+СтрИмя+")"));
EndIf;
Result:=1;
EndFunction

//Загрузка нужных системных функций
aUser32:=Lib.Load("user32.dll");
aUser32.RegisterFunction("EnumWindows","stdcall","P,N","B32");
aUser32.RegisterFunction("GetWindowTextW:GetWindowText","stdcall","N,@SZW4096,I32","I32");
aUser32.RegisterFunction("GetClassNameW:GetClassName","stdcall","N,@SZW4096,I32","I32");
aUser32.RegisterFunction("IsWindowVisible","stdcall","N","B32");

//Создание функции объекта для вызова EnumWindowsProc из системной области памяти
aEnumWindowsProc:=Lib.CreateCallbackFunction("EnumWindowsProc",,"stdcall","I32,N","B32");

//Вызов системной функции EnumWindowsProc, которая, в свою очередь, будет вызывать созданную ранее EnumWindowsProc для каждого найденного окна
aUser32.EnumWindows(aEnumWindowsProc,0);
</pre>

GlobalStringsSaveToFile

Admin — Wed, 01 Apr 2026 09:59:06 GMT

Admin imported GlobalStringsSaveToFile by file upload (1 revision)

New page

{{infobox function
|name=GlobalStringsSaveToFile
|object=[[Функции общего назначения]]
|caption=Глобальные строки-массивы
|type=1
|status=2
|db=0
|exception=Неверные агрументы, системная ошибка сервера, не найден массив.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция выполняет сохранение массива на диск в файловой системе сервера в виде файла. Обычно она выполняется автоматически, если в массиве были изменения после определенного количества времени.
== Синтаксис ==
<code>
'''GlobalStringsSaveToFile'''(''<Имя или идентификатор массива (STRING,INT)>''{{Optional|,<Имя файла на сервере (STRING)>,<Если время последней записи было не раньше в мс. (INT)>{{Default|{{Eq}}0}}}}):''<1 или 0>''
</code>
==== Аргументы ====
* <code>''<Имя или идентификатор массива (STRING,INT)>''</code> - Параметр задает имя массива (строка) или идентификатор массива (число).
* <code>''<Имя файла на сервере (STRING)>''</code> - {{Optional}} Аргумент, строковое представление которого будет представлять имя файла в [[Имена файлов|нотации системы]]. На данный момент принимается только путь к файлам на сервере. Если аргумент не задан, используется тот файл, который был указан при создании массива, см. [[GlobalStringsHeapsAdd]].
* <code>''<Если время последней записи было не раньше в мс. (INT)>''</code> - {{Optional}} {{Planned}} Сохранение будет выполняться только если последнее автоматическое или вызванное этой функцией сохранение было не ранее указанного количества миллисекунд назад. По умолчанию, '''0''', выполняется безусловное сохранение.
==== Возвращаемое значение ====
Возвращает 1, если сохранение выполнено успешно (или не требуется, так как предыдущее было выполнено недавно), 0, если сохранение не удалось выполнить (к примеру, из-за того, что файл был занят).

== Примеры ==
<pre>
GlobalStringsSaveToFile(Массив,"Temp\Массивы\Current.bin");
</pre>

GlobalStringsShrink

Admin — Wed, 01 Apr 2026 09:59:06 GMT

Admin imported GlobalStringsShrink by file upload (1 revision)

New page

{{infobox function
|name=GlobalStringsShrink
|object=[[Функции общего назначения]]
|caption=Глобальные строки-массивы
|type=1
|status=2
|db=0
|exception=Неверные агрументы, системная ошибка сервера, не найден массив.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция форсирует процедуру сжатия памяти буферов массива, которая обычно выполняется автоматически после определенного количества удалений из массива.
== Синтаксис ==
<code>
'''GlobalStringsShrink'''(''<Имя или идентификатор массива (STRING,INT)>''{{Optional|,''<Порог сжатия в % (INT)>''{{Default|{{Eq}}0}}}})
</code>
==== Аргументы ====
* <code>''<Имя или идентификатор массива (STRING,INT)>''</code> - Параметр задает имя массива (строка) или идентификатор массива (число).
* <code>''<Порог сжатия в % (INT)>''</code> - {{Optional}} Аргумент задает процент свободного места в данных буфера по отношению к размеру данных в буфере для инициации процедуры сжатия для буфера. Проверки выполняются для отдельных буферов, множество которых входят в один массив. По умолчанию -- 0%, безусловное сжатие.

== Примеры ==
<pre>
//Выполнить удаление большого количества значений из массива Массив
GlobalStringsRemove(Массив,СтрЗначения,0);

//Сжать буферы массива, освободив память, если место, занимаемое полезными данными в них, менее половины объема буферов
GlobalStringsShrink(Массив,50);
</pre>

GlobalStringsAdd

Admin — Wed, 01 Apr 2026 09:59:05 GMT

Admin imported GlobalStringsAdd by file upload (1 revision)

New page

{{infobox function
|name=GlobalStringsAdd
|object=[[Функции общего назначения]]
|caption=Глобальные строки-массивы
|type=1
|status=2
|db=0
|exception=Неверные агрументы, системная ошибка сервера, не найден массив.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция добавляет произвольное количество строк из списка или одной строки с разделителями в массив, заданный по его наименованию или идентификатору. Режим функции задает условие добавления, а также формат ответа (последний может быть как числовым, так и в виде списка).
== Синтаксис ==
<code>
'''GlobalStringsAdd'''(''<Имя или идентификатор массива (STRING,INT)>'',''<Значения (STRING,LIST)>''{{Optional|,''<Режим (INT)>''{{Default|{{Eq}}0}}}}):''<Статус или результат (INT,LIST)>''
</code>
==== Аргументы ====
* <code>''<Имя или идентификатор массива (STRING,INT)>''</code> - Параметр задает имя массива (строка) или идентификатор массива (число) для добавления значений.
* <code>''<Значения (STRING,LIST)>''</code> - Значения для добавления могут быть в списке или в строке. Каждое значение может содержать префикс, отделенный от основной строки разделителем префикса (см. [[GlobalStringsHeapsAdd]]). При добавлении из строки, каждое значение (с префиксом) должно быть разделено разделителем значений (см. [[GlobalStringsHeapsAdd]]).
* <code>''<Режим (INT)>''</code> - {{Optional}} Аргумент задает режим добавления и является битовой маской. На данный момент доступны следующие биты:
** '''бит 0''' -- если установлен, функция возвращает список уже присутствующих (из добавляемых) в массиве значений, иначе статус будет числом (см. ниже).
** '''бит 1''' -- если установлен, функция добавляет те значения, которых нет, игнорируя те, что уже присутствуют в массиве. Если сброшен (по умолчанию), функция не изменяет массив, если по крайней мере одно из добавляемых значений уже содержится в массиве.
** '''бит 2''' -- если установлен, функция обновит префиксы для значений, которые уже присутствовали в массиве (в не зависимости от того, установлен ли бит 1 или нет).
** '''бит 3''' -- если установлен (и не установлен бит 0), функция возвращает только 0 (все значения новые) или 1 (некоторые значения присутствовали в массиве). Вместо статуса 2 (все значения уже присутствовали в массиве) также возвращается число 1, что позволяет выполнить операцию немного быстрее.
==== Возвращаемое значение ====
Если бит 0 аргумента режима сброшен (по умолчанию), возвращает следующее числовое значение: '''0''' -- все значения новые и были добавлены в массив, '''1''' -- некоторые значения присутствовали в массиве (по умолчанию, в массив ничего не добавлено, но при установке бита 1 аргумента режима, отсутствующие значения все-таки были добавлены, также в зависимости от бита 2 режима, в массиве могли быть обновлены префиксы найденных значений), '''2''' -- все значения уже присутствали в массиве (в зависимости от бита 2 режима, в массиве могли быть обновлены префиксы значений). Если бит 0 аргумента режима установлен, функция возвращает список.

== Примеры ==
<pre>
Массив:=GlobalStringsHeapsFind("MRK"+FormatDate(Date(),"YYYYmmdd"));

...
//Находится строка добавления СтрНовыеМарки, значения разделены заранее заданной строкой-разделителем.
...

If Массив>0 Then
GlobalStringsAdd(Массив,СтрНовыеМарки,6);//форсированное добавление, обновление префиксов, если они изменились
EndIf;
</pre>

GlobalStringsAddFromFile

Admin — Wed, 01 Apr 2026 09:59:05 GMT

Admin imported GlobalStringsAddFromFile by file upload (1 revision)

New page

{{infobox function
|name=GlobalStringsAddFromFile
|object=[[Функции общего назначения]]
|caption=Глобальные строки-массивы
|type=1
|status=2
|db=0
|exception=Неверные агрументы, системная ошибка сервера, не найден массив.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция выполняет добавление сохраненного ранее массива с диска в файловой системе сервера к массиву, заданному по наименованию или идентификатору. Обычно она выполняется автоматически при создании массива, если указан файл его хранения.
== Синтаксис ==
<code>
'''GlobalStringsAddFromFile'''(''<Имя или идентификатор массива (STRING,INT)>'',''<Имя файла на сервере (STRING)>''{{Optional|,''<Очистить массив перед загрузкой (INT)>''{{Default|{{Eq}}0}}}}):''<1 или 0>''
</code>
==== Аргументы ====
* <code>''<Имя или идентификатор массива (STRING,INT)>''</code> - Параметр задает имя массива (строка) или идентификатор массива (число).
* <code>''<Имя файла на сервере (STRING)>''</code> - Аргумент, строковое представление которого будет представлять имя файла в [[Имена файлов|нотации системы]]. На данный момент принимается только путь к файлам на сервере.
* <code>''<Очистить массив перед загрузкой (INT)>''</code> - {{Optional}} Массив, заданный первым агрументом будет очищен, перед загрузкой, если данный аргумент равен ''1''. По умолчанию, ''0'', данные будут добавлены к текущему массиву.
==== Возвращаемое значение ====
Возвращает 1, если загрузка выполнена успешно, 0, если загрузку не удалось выполнить (к примеру, файл не существовал).

== Примеры ==
<pre>
GlobalStringsAddFromFile(Массив,"Temp\Массивы\Current.bin");
</pre>

GlobalStringsFind

Admin — Wed, 01 Apr 2026 09:59:05 GMT

Admin imported GlobalStringsFind by file upload (1 revision)

New page

{{infobox function
|name=GlobalStringsAdd
|object=[[Функции общего назначения]]
|caption=Глобальные строки-массивы
|type=1
|status=2
|db=0
|exception=Неверные агрументы, системная ошибка сервера, не найден массив.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция выполняет поиск произвольного количества строк, заданных в списке или в одной строке с разделителями, в массиве по его наименованию или идентификатору. Режим функции задает условие поиска, а также формат ответа (последний может быть как числовым, так и в виде списка).
== Синтаксис ==
<code>
'''GlobalStringsFind'''(''<Имя или идентификатор массива (STRING,INT)>'',''<Значения (STRING,LIST)>''{{Optional|,''<Режим (INT)>''{{Default|{{Eq}}0}}}}):''<Статус или результат (INT,LIST)>''
</code>
==== Аргументы ====
* <code>''<Имя или идентификатор массива (STRING,INT)>''</code> - Параметр задает имя массива (строка) или идентификатор массива (число) для поиска значений.
* <code>''<Значения (STRING,LIST)>''</code> - Значения для поиска могут быть в списке или в строке. Каждое значение может содержать префикс, отделенный от основной строки разделителем префикса (см. [[GlobalStringsHeapsAdd]]). Если аргумент строка, каждое значение (с префиксом) должно быть разделено разделителем значений (см. [[GlobalStringsHeapsAdd]]).
* <code>''<Режим (INT)>''</code> - {{Optional}} Аргумент задает режим поиска и является битовой маской. На данный момент доступны следующие биты:
** '''бит 0''' -- если установлен, функция возвращает список уже найденных в массиве значений, иначе статус будет числом (см. ниже).
** '''бит 3''' -- если установлен (и не установлен бит 0), функция возвращает только 0 (все значения найдены) или 1 (некоторые значения найдены). Вместо статуса 2 (все значения найдены) также возвращается число 1, что позволяет выполнить операцию немного быстрее.
==== Возвращаемое значение ====
Если бит 0 аргумента режима сброшен (по умолчанию), возвращает следующее числовое значение: '''0''' -- все значения были найдены в массиве, '''1''' -- некоторые значения были найдены в массиве, '''2''' -- все значения были найдены в массиве. Если бит 0 аргумента режима установлен, функция возвращает список найденных значений.

== Примеры ==
<pre>
//СтрКоды -- значения для поиска дублей
//СпМассивыМарок -- список массивов, где производится поиск дублей
СпДубли:=List.Create();
For i:=1 To СпМассивыМарок.Size() Do
Try
//Возвратить список и добавить его содержимое к списку СпДубли
GlobalStringsFind(СпМассивыМарок[i],СтрКоды,1).CopyTo(СпДубли);
Except
//Возможно, один из старых массивов был удален до этой операции другим пользователем
EndTry;
EndDo;
//СпДубли -- список найденных дублей для вывода
</pre>

GlobalStringsHeapsFind

Admin — Wed, 01 Apr 2026 09:59:05 GMT

Admin imported GlobalStringsHeapsFind by file upload (1 revision)

New page

{{infobox function
|name=GlobalStringsHeapsFind
|object=[[Функции общего назначения]]
|caption=Глобальные строки-массивы
|type=1
|status=2
|db=0
|exception=Системная ошибка сервера
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция проверяет, существует ли на сервере массив по его наименованию. Если массив существует, будет возвращен его идентификатор, иначе ноль.
== Синтаксис ==
<code>
'''GlobalStringsHeapsFind'''(''<Имя массива (STRING)>''):''<Идентификатор или ноль (INT)>''
</code>
==== Аргументы ====
* <code>''<Имя массива (STRING)>''</code> - Параметр задает имя массива по наименованию (строка) или идентификатору (число).

==== Возвращаемое значение ====
Возвращает числовое значение.

== Примеры ==
<pre>
аДата:=BegOfDay(Date());
If GlobalStringsHeapsFind("MRK"+FormatDate(аДата,"YYYYmmdd"))>0 Then
Message("Массив за сегодня уже был создан!");
EndIf;
</pre>

GlobalStringsRemove

Admin — Wed, 01 Apr 2026 09:59:05 GMT

Admin imported GlobalStringsRemove by file upload (1 revision)

New page

{{infobox function
|name=GlobalStringsRemove
|object=[[Функции общего назначения]]
|caption=Глобальные строки-массивы
|type=1
|status=2
|db=0
|exception=Неверные агрументы, системная ошибка сервера, не найден массив.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция удаляет произвольное количество строк из списка или одной строки с разделителями из массива, заданного по его наименованию или идентификатору. Режим функции задает условие удаления, а также формат ответа (последний может быть как числовым, так и в виде списка).
== Синтаксис ==
<code>
'''GlobalStringsRemove'''(''<Имя или идентификатор массива (STRING,INT)>'',''<Значения (STRING,LIST)>''{{Optional|,''<Режим (INT)>''{{Default|{{Eq}}0}}}}):''<Статус или результат (INT,LIST)>''
</code>
==== Аргументы ====
* <code>''<Имя или идентификатор массива (STRING,INT)>''</code> - Параметр задает имя массива (строка) или идентификатор массива (число) для удаления значений.
* <code>''<Значения (STRING,LIST)>''</code> - Значения для удаления могут быть в списке или в строке. Каждое значение может содержать префикс, отделенный от основной строки разделителем префикса (см. [[GlobalStringsHeapsAdd]]). При добавлении из строки, каждое значение (с префиксом) должно быть разделено разделителем значений (см. [[GlobalStringsHeapsAdd]]).
* <code>''<Режим (INT)>''</code> - {{Optional}} Аргумент задает режим удаления и является битовой маской. На данный момент доступны следующие биты:
** '''бит 0''' -- если установлен, функция возвращает список удаленных из массива значений (только те, что были найдены), иначе статус будет числом (см. ниже).
** '''бит 1''' -- если установлен, функция не выполняет удаления значений, если хотя бы одно из них отсутствует в массиве на момент выполнения операции. Если сброшен (по умолчанию), функция удаляет найденные, вне зависимости от того, все ли значения присутствуют в массиве.
==== Возвращаемое значение ====
Если бит 0 аргумента режима сброшен (по умолчанию), возвращает следующее числовое значение: '''0''' -- ни одно из искомых значений не было найдено в массиве (удаления не производилось), '''1''' -- некоторые значения присутствовали в массиве (по умолчанию, он были удалены из массива, но при установке бита 1 аргумента режима, массив не был изменен), '''2''' -- все значения присутствали в массиве и были удалены. Если бит 0 аргумента режима установлен, функция возвращает список.

== Примеры ==
<pre>

...
//СтрСтарыеМарки: значения для удаления разделены заранее заданной строкой-разделителем.
//СпМассивыМарок: массивы, созданные на данный момент
If СтрСтарыеМарки<>"" Then
For i:=1 To СпМассивыМарок.Size() Do
Try
GlobalStringsRemove(СпМассивыМарок[i],СтрСтарыеМарки,0);//Удалить те, которые были найдены
Except
//Возможно, один из старых массивов был удален до этой операции другим пользователем
EndTry;
EndDo;
EndIf;

</pre>

GetModuleFunction

Admin — Wed, 01 Apr 2026 09:59:04 GMT

Admin imported GetModuleFunction by file upload (1 revision)

New page

{{infobox function
|name=GetModuleFunction
|object=[[Функции общего назначения]]
|caption=Системные функции
|type=1
|status=2
|db=0
|exception=Невозможно превратить в число, неверный уровень функции.
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция отдает объект компилированной функции, находящейся на требуемом уровне над текущей исполняемой функцией (этот объект, если найден, всегда включает текущую исполняемую функцию). В дальнейшем этот объект можно использовать для вызова функций по именам (см. [[ExecuteFunction]]), или экспортирования функции.
== Синтаксис ==
<code>
'''GetModuleFunction'''({{Optional|<Уровень родительской функции от текущей (INT)>{{Default|{{Eq}}0}}}}):''<Требуемая функция в виде объекта (COMPILEDFUNCTION)>''
</code>
==== Аргументы ====
* <code>''<Уровень родительской функции от текущей (INT)>''</code> - {{Optional}} Аргумент задает требуемый уровень родительской функции. По-умолчанию, ''0'', объект содается для текущей функции. Нужнопонимать, что уровень родителя здесь, это не уровень вызова (рекурсии), а уровень исходного текста.

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

== Примеры ==
<pre>
//Пример показывает разницу между уровенем исходного текста при получении функции и уровнем рекурсии,
// а также глобальными переменными, доступными в контексте исполнения, а не внутри объекта функции.
Var Счетчик Export;

Function Рекурсия()
Счетчик:=Счетчик+1;
Message("Счетчик (вложенность вызова): "+Счетчик);
If Счетчик>99 Then
Message("Выходим из рекурсии.");
Exit;
EndIf;
//Получим объект функции, в которой располагается текущая функция Рекурсия()
аФункция:=GetModuleFunction(1);
//Выполним вызов из этого объекта
ExecuteFunction("Рекурсия",аФункция);
EndFunction

Счетчик:=0;
Рекурсия();
//В логе должно отобразиться: 100 строк "Счетчик (вложенность вызова): ??" и последняя строка "Выходим из рекурсии.".
</pre>

GIObject.LinkEvent

Admin — Wed, 01 Apr 2026 09:59:03 GMT

Admin imported GIObject.LinkEvent by file upload (1 revision)

New page

{{infobox function
|name=LinkEvent
|object=[[Объект GI#Атрибуты и функции графических объектов|Графический объект объекта GI]]
|caption=Функции графических объектов
|type=1
|status=2
|db=0
|exception=Неверные аргументы.
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект GI]]}}
Функция ассоциирует локальную функцию по ее имени со стандартным событием графического объекта. Также функции может передаваться один произвольный аргумент при ее вызове. На данный момент доступны следующие стандартные события объектов: '''OnDraw''', '''OnNewInput''', '''OnChange''', '''OnMove'''.

== Синтаксис ==
<code>
{{Grey|GIObject.}}'''LinkEvent'''(''<Имя события (STRING)>''{{OptionalByRef|,<Имя локальной функции (STRING)>,<Глубина поиска (INT)>{{Default|{{Eq}}0}},<Аргумент функции>}})
</code>

==== Аргументы ====
* <code>''<Имя события (STRING)>''</code> - Аргумент задает имя события для ассоциации. На данный момент доступны следующие имена событий:
** '''OnDraw''': Событие вызывается в момент необходимости нарисовать текущий объект. В нем можно разместить произвольный код для прорисовки и в нужный момент вызвать функцию [[GIObject.DrawObject|DrawObject]], которая выполняет саму прорисовку объекта. Локальная функция для вызова этого события должна содержать три аргумента -- объект GI, рисуемый графический объект и доп. параметр, заданный в этой функции, пример: <code>Function Прорисовка(aGI,аОбъект,ДопПараметр)</code>.
** '''OnNewInput''': {{Planned}} Событие будет вызываться в момент получения новой информации от внешних устройств ввода (клавиатура, мышь, контроллер), когда объект имеет фокус, либо в момент получения или потери фокуса объектом.
** '''OnChange''': {{Planned}} Событие будет вызываться в момент изменения статуса объекта или его определенных атрибутов.
** '''OnMove''': {{Planned}} Событие будет вызываться в момент движения, вращения или мастабирования объекта.
* <code>''<Имя локальной функции (STRING)>''</code> - Аргумент задает имя локальной или глобальной функции, которая будет вызываться при наступлении события.
* <code>''<Глубина поиска (INT)>''</code> - {{Optional}} Задает способ поиска локальной функции. Может принимать следующие значения:
** -1 -- выполнять поиск по последовательности функций из стека вызовов, а не искать, используя подчинение функций на момент компиляции. Этот способ предпочтительнее использовать в компилированных функциях, вызываемых из разных мест модуля или из разных модулей, чтобы получить доступ к реальной среде функций, а не к оной на момент компиляции.
** 0 (по умолчанию) -- выполнять поиск во всех модулях [[Общее описание языка#Вложенность функций и модулей, уровни вложенности|большего уровня вложенности]] (родительских) и во всех глобальных модулях.
** 1 -- выполнять поиск только внутри текущего модуля.
** 2 -- выполнять поиск только внутри родительского модуля.
** 3..x -- выполнять поиск только внутри родительского модуля указанного уровня (к примеру, для уровня 3, выполнять поиск только в родителе родителя текущего модуля).
* <code>''<Аргумент функции>''</code> - {{Optional}} Содержит произвольное значение, которое будет передано локальной функции третим аргументом при ее вызове.

== Примеры ==
<pre>
//Используется фрагмент из обработки tetris.sfo

Function OnDrawObject(aGI,aObj)
aGI.ShaderProgramSetVariable(лкПрограммы[2],"u_offset",,0,лкТекущаяФигура[5]*лкШиринаКвадрата);
aObj.DrawObject();
aGI.ShaderProgramSetVariable(лкПрограммы[2],"u_offset",,0,0);
EndFunction

...
аМодель:=GIModel.New();
аМодель.SimpleModel(Buffer.Create());
аОбъектФигуры:=aGI.AddObject();
аОбъектФигуры.Model(аМодель);
аОбъектФигуры.LinkEvent("ONDRAW","OnDrawObject",1);
лкОбъекты[2]:=аОбъектФигуры;

</pre>

GI.LinkEvent

Admin — Wed, 01 Apr 2026 09:59:01 GMT

Admin imported GI.LinkEvent by file upload (1 revision)

New page

{{infobox function
|name=LinkEvent
|object=[[Объект GI]]
|caption=Общие функции объекта GI
|type=1
|status=2
|db=0
|exception=Неверные аргументы, локальная функция не найдена.
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект GI]]}}
Функция ассоциирует локальную функцию по ее имени со стандартным событием объекта ''GI''. Предыдущая ассоциация при этом удаляется. Также функции может передаваться один произвольный аргумент. На данный момент доступны следующие стандартные события: '''OnDraw''', '''OnResize''', '''OnNewInput'''.

== Синтаксис ==
<code>
{{Grey|GI.}}'''LinkEvent'''(''<Имя события (STRING)>''{{Optional|,<Имя локальной функции (STRING)>,<Глубина поиска (INT)>{{Default|{{Eq}}0}},<Аргумент функции>}})
</code>

==== Аргументы ====
* <code>''<Имя события (STRING)>''</code> - Аргумент задает имя события для ассоциации. На данный момент доступны следующие имена событий:
** '''OnDraw''': Событие вызывается в момент прорисовки кадра из функции [[GI.InitiateRedraw|InitiateRedraw]]. В нем можно разместить произвольный код для прорисовки и в нужный момент вызвать функцию [[GI.DrawScene|DrawScene]], которая выполняет рисование всех графических объектов. Локальная функция для вызова этого события должна содержать два аргумента -- объект GI и доп. параметр, заданный в этой функции, пример: <code>Function Прорисовка(ОбъектGI,ДопПараметр)</code>.
** '''OnResize''': Событие вызывается в момент изменения размера окна ''GI'' из функции [[GI.InitiateRedraw|InitiateRedraw]]. В нем можно разместить произвольный код, связанный с изменением размеров рисуемых элементов. Локальная функция для вызова этого события должна содержать четыре аргумента (разрешается не указывать два последних) -- объект GI и доп. параметр, заданный в этой функции, новая ширина окна ''GI'', новая высота окна ''GI'', пример: <code>Function ИзменилосьОкно(ОбъектGI,ДопПараметр,ШиринаОкна,ВысотаОкна)</code>.
** '''OnNewInput''': Событие вызывается в момент получения новой информации от внешних устройств ввода (клавиатура, мышь, контроллер), либо в момент получения или потери фокуса окном ''GI'' из функции [[GI.InitiateRedraw|InitiateRedraw]]. В нем можно разместить произвольный код, связанный с реакцией на эти события. Локальная функция для вызова этого события может содержать до семи аргументов (пример: <code>Function СобытиеВводаДанных(ОбъектGI,ДопПараметр,ТипСобытия,Арг1,Арг2,Арг3,Арг4)</code>), описание аргументов предлагается ниже:
*** '''ОбъектGI''': передает текущий объект ''GI'', для которого вызывается событие.
*** '''ДопПараметр''': передает значение дополнительного параметра, заданного в функции ''LinkEvent''.
*** '''ТипСобытия''': передает цифровой тип события, на данный момент доступные следующие типы:
**** '''0-9''': события, связанные с мышью. Назначение аргументов: Арг1 -- клавиша, колесо мыши или ноль, Арг2 -- позиция мыши X, Арг3 -- позиция мыши Y, Арг4 -- нажатые клавиши мыши. Причем:
***** '''0''' -- движение мыши, аргументы ''Арг2'' и ''Арг3'' задают новое положение мыши относительно левой верхней точки окна ''GI'', ''Арг4'' задает битовую маску нажатых в данный момент клавиш мыши (бит 0 -- левая клавиша, бит 1 -- правая клавиша, бит 4 -- средняя клавиша и пр.).
***** '''1''' -- нажата клавиша мыши, аргумент ''Арг1'' задает номер нажатой клавиши (0 -- левая, 1 -- правая, 2 -- средняя), остальные аргументы соответствуют аргументам для события движения мыши (см. выше).
***** '''2''' -- отпущена клавиша мыши, аргумент ''Арг1'' задает номер отпущенной клавиши (0 -- левая, 1 -- правая, 2 -- средняя), остальные аргументы соответствуют аргументам для события движения мыши (см. выше).
***** '''3''' -- событие движения колеса мыши, аргумент ''Арг1'' задает число -- значение прокрутки колеса мыши, остальные аргументы соответствуют аргументам для события движения мыши (см. выше).
**** '''10-19''': события, связанные с клавиатурой. Назначение аргументов: Арг1 -- виртуальный код клавиши, Арг2 -- является ли клавиша дополнительной (extended), Арг3, Арг4 -- не заполнятся. Причем:
***** '''10''' -- произошло повторение предыдущего нажатия клавиши, так как она продолжает быть удерживаемой.
***** '''11''' -- нажата клавиша клавиатуры.
***** '''12''' -- отпущена клавиша клавиатуры.
**** '''20-29''': события, связанные с фокусом окна ''GI''. Дополнительные аргумента Арг1, Арг2, Арг3, Арг4 не заполнятся. Причем:
***** '''20''' -- Окно ''GI'' получило фокус.
***** '''21''' -- Окно ''GI'' потеряло фокус.
* <code>''<Имя локальной функции (STRING)>''</code> - Аргумент задает имя локальной или глобальной функции, которая будет вызываться при наступлении события.
* <code>''<Глубина поиска (INT)>''</code> - {{Optional}} Задает способ поиска локальной функции. Может принимать следующие значения:
** -1 -- выполнять поиск по последовательности функций из стека вызовов, а не искать, используя подчинение функций на момент компиляции. Этот способ предпочтительнее использовать в компилированных функциях, вызываемых из разных мест модуля или из разных модулей, чтобы получить доступ к реальной среде функций, а не к оной на момент компиляции.
** 0 (по умолчанию) -- выполнять поиск во всех модулях [[Общее описание языка#Вложенность функций и модулей, уровни вложенности|большего уровня вложенности]] (родительских) и во всех глобальных модулях.
** 1 -- выполнять поиск только внутри текущего модуля.
** 2 -- выполнять поиск только внутри родительского модуля.
** 3..x -- выполнять поиск только внутри родительского модуля указанного уровня (к примеру, для уровня 3, выполнять поиск только в родителе родителя текущего модуля).
* <code>''<Аргумент функции>''</code> - {{Optional}} Содержит произвольное значение, которое будет передано локальной функции вторым аргументом при ее вызове.

== Примеры ==
<pre>

//Событие движения мыши и нажатия на клавиши
Function OnNewInput(aGI,СпУскор,ТипСобытия,Арг1,Арг2,Арг3,Арг4)
If ТипСобытия=0 Then
//Движение мыши -- обновить переменные поворота
//Арг2, Арг3 -- смещение мыши по X и Y относительно окна прорисовки
If aGI.MouseCaptured Then
СпУскор[4]:=Арг2-aGI.Width div 2;
СпУскор[5]:=Арг3-aGI.Height div 2;
EndIf;
ElseIf ТипСобытия=1 Then
//Нажатие мыши на экран, захватить мышь
aGI.CaptureMouse();
ElseIf ТипСобытия=11 Then //Клавиша нажата
If (Арг1=0x57)Or(Арг1=0x26) Then//W или стрелка вперед -- движение по Z
СпУскор[3]:=1;
ElseIf (Арг1=0x53)Or(Арг1=0x28) Then//S или стрелка назад -- движение по Z
СпУскор[3]:=-1;
ElseIf (Арг1=0x51)Or(Арг1=0x25) Then//Q или стрелка влево -- движение по X
СпУскор[1]:=-1;
ElseIf (Арг1=0x45)Or(Арг1=0x27) Then//E или стрелка вправо -- движение по X
СпУскор[1]:=1;
ElseIf (Арг1=0x20)Or(Арг1=0x41) Then//A или пробел -- прыжок
СпУскор[2]:=1;
ElseIf Арг1=0x1B Then//ESC -- отпустить мышь
aGI.ReleaseMouse();
EndIf;
ElseIf ТипСобытия=12 Then //Клавиша отпущена
If ((Арг1=0x57)Or(Арг1=0x26))And(СпУскор[3]=1) Then//Отменить движение по Z, если оно было инициировано W
СпУскор[3]:=0;
ElseIf ((Арг1=0x53)Or(Арг1=0x28))And(СпУскор[3]=-1) Then//Отменить движение по Z, если оно было инициировано S
СпУскор[3]:=0;
ElseIf ((Арг1=0x51)Or(Арг1=0x25))And(СпУскор[1]=-1) Then//Отменить движение по X, если оно было инициировано Q
СпУскор[1]:=0;
ElseIf ((Арг1=0x45)Or(Арг1=0x27))And(СпУскор[1]=1) Then//Отменить движение по X, если оно было инициировано E
СпУскор[1]:=0;
ElseIf _Or(Арг1=0x20,Арг1=0x41) Then//Отменить прыжок
СпУскор[2]:=0;
EndIf;
ElseIf ТипСобытия=21 Then//Потеря фокуса окном, отпустить мышь
aGI.ReleaseMouse();
EndIf;
EndFunction

...
//Инициализация графического объекта для элемента аЭлемент: режим выделенного цикла, двойная буферизация
aGI:=GI.Init(аЭлемент,,1,1);

//Внутренние переменные, для использования в обработчиках событий
СпУскор:=List.Create(0,0,0,0,0); //Переменные ускорения: по x, по y, по z,поворот мыши по x,поворот мыши по y

//Автоматически захватывать мышь
aGI.MouseMode(1);
//Указание на функции обработчиков событий
aGI.LinkEvent("ONDRAW","OnDraw",1,СпКоорд);
aGI.LinkEvent("ONNEWINPUT","OnNewInput",1,СпУскор);
//Включить режим фильтрации MSAA
aGI.AntiAliasing(1);
//Включить режим ограничения кадров по развертке экрана
aGI.FrameLimiter(1);
//Включить 3D перспективу, FOV 90
aGI.WorldPerspective(0,90,0.1,1000);

...
</pre>

ExecuteFunction

Admin — Wed, 01 Apr 2026 09:58:39 GMT

Admin imported ExecuteFunction by file upload (1 revision)

New page

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

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

==== Возвращаемое значение ====
Возвращает результат исполнения функции.

== Примеры ==
<pre>
//Визуальное событие OnClick в макросе, состоящем из группы кнопок
//Событие вызывает функции в локальном модуле, на форме которого размещен макрос

//Событие в локальном модуле может отменить обработку документа
//флПарам -- параметр, передаваемый в модуль обработки документа, может быть изменен функцией OnBeforeDocumentSaveOrPublish
//ФлТип -- если OnBeforeDocumentSaveOrPublish возвратит 0, обработка будет отменена
// 1 -- обработка будет выполнена
// 2 -- обработку выполнила сама функция OnBeforeDocumentSaveOrPublish, выполнять ее здесь не требуется
флПарам:=0;
ФлТип:=0;
If DoesFunctionExist("OnBeforeDocumentSaveOrPublish",1) Then
ФлТип:=Number(ExecuteFunction("OnBeforeDocumentSaveOrPublish",1,1,флПарам));
If ФлТип=0 Then
Exit;
EndIf;
EndIf;

//Далее следует блок обработки документа
If ФлТип<>2 Then
Try
If aEl.Status()<0 Then //Документ необходимо записать, если он новый
aEl.Save();
EndIf;
if not aEl.Publish(флПарам) Then
Exit;
EndIf;
Except
Message(глПодготовитьОшибкуОбработки(),"!");
Exit;
EndTry;
EndIf;

//Событие в локальном модуле может произвести действия, необходимые после обработки документа
If DoesFunctionExist("OnAfterDocumentSaveOrPublish",1) Then
ExecuteFunction("OnAfterDocumentSaveOrPublish",1,1,флПарам);
EndIf;
</pre>

<pre>
//Пример показывает исполнение определенной функции из компилированного блока текста
//Заметьте: вызванная таким образом функция HelloWorld не имеет доступа к переменной Перем1, заданной в блоке для компиляции

//Блок текста для компиляции
Стр:="Var Перем1 Export;
|
|Function HelloWorld(Arg1)
| Message(""Аргумент: ""+Arg1);
| Result:=132;
|EndFunction;
|
|Message(""Исполнение вне функции HelloWorld"");";

//Компилируем блок текста, получаем объект аФунк
аФунк:=Compile(Стр);

//На экран будет выведено последовательно:
//"Аргумент: Строковой аргумент"
//"Результат: 132"
Message("Результат: "+ExecuteFunction("HelloWorld",аФунк,"Строковой аргумент"));
</pre>

DoesFunctionExist

Admin — Wed, 01 Apr 2026 09:58:38 GMT

Admin imported DoesFunctionExist by file upload (1 revision)

New page

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

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

==== Возвращаемое значение ====
Возвращает 1, если функция найдена, 0, если она не существует.

== Примеры ==
<pre>
//Визуальное событие OnClick в макросе, состоящем из группы кнопок
//Событие вызывает функции в локальном модуле, на форме которого размещен макрос

//Событие в локальном модуле может отменить обработку документа
//флПарам -- параметр, передаваемый в модуль обработки документа, может быть изменен функцией OnBeforeDocumentSaveOrPublish
//ФлТип -- если OnBeforeDocumentSaveOrPublish возвратит 0, обработка будет отменена
// 1 -- обработка будет выполнена
// 2 -- обработку выполнила сама функция OnBeforeDocumentSaveOrPublish, выполнять ее здесь не требуется
флПарам:=0;
ФлТип:=0;
If DoesFunctionExist("OnBeforeDocumentSaveOrPublish",1) Then
ФлТип:=Number(ExecuteFunction("OnBeforeDocumentSaveOrPublish",1,1,флПарам));
If ФлТип=0 Then
Exit;
EndIf;
EndIf;

//Далее следует блок обработки документа
If ФлТип<>2 Then
Try
If aEl.Status()<0 Then //Документ необходимо записать, если он новый
aEl.Save();
EndIf;
if not aEl.Publish(флПарам) Then
Exit;
EndIf;
Except
Message(глПодготовитьОшибкуОбработки(),"!");
Exit;
EndTry;
EndIf;

//Событие в локальном модуле может произвести действия, необходимые после обработки документа
If DoesFunctionExist("OnAfterDocumentSaveOrPublish",1) Then
ExecuteFunction("OnAfterDocumentSaveOrPublish",1,1,флПарам);
EndIf;
</pre>

BroadcastChannelReceiveMessage

Admin — Wed, 01 Apr 2026 09:57:50 GMT

Admin imported BroadcastChannelReceiveMessage by file upload (1 revision)

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>

BroadcastChannelSendMessage

Admin — Wed, 01 Apr 2026 09:57:50 GMT

Admin imported BroadcastChannelSendMessage by file upload (1 revision)

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>

BroadcastChannelSubscribe

Admin — Wed, 01 Apr 2026 09:57:50 GMT

Admin imported BroadcastChannelSubscribe by file upload (1 revision)

New page

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

== Синтаксис ==
<code>
'''BroadcastChannelSubscribe'''(''<Имя канала (STRING)>''{{Optional|,<Форма-получатель или ее серийный номер (FORM,INT)>{{Default|{{Eq}}0}}}}):''<Числовой идентификатор канала (INT)>''
</code>
==== Аргументы ====
* <code>''<Имя канала (STRING)>''</code> - Произвольное имя канала для подписки.
* <code>''<Форма-получатель или ее серийный номер (FORM,INT)>''</code> - {{Optional}} Указание на форму, если необходимо поулчать сообщения в виде события ''[[Студия/OnMessage|OnMessage]]''. Форма может быть задана серийным номером или самим объектом формы.

==== Возвращаемое значение ====
Возвращает числовой идентификатор канала на сервере.

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

BroadcastChannelUnsubscribe

Admin — Wed, 01 Apr 2026 09:57:50 GMT

Admin imported BroadcastChannelUnsubscribe by file upload (1 revision)

New page

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

== Синтаксис ==
<code>
'''BroadcastChannelUnsubscribe'''(''<Имя или идентификатор канала (INT,STRING)>'')
</code>
==== Аргументы ====
* <code>''<Имя или идентификатор канала (INT,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>

ArgumentsNumber

Admin — Wed, 01 Apr 2026 09:57:49 GMT

Admin imported ArgumentsNumber by file upload (1 revision)

New page

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

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

==== Возвращаемое значение ====
Возвращает количество аргументов найденной функции или -1, если функция не найдена.

== Примеры ==
<pre>
//Визуальное событие OnClick в макросе, состоящем из группы кнопок
//Событие вызывает функции в локальном модуле, на форме которого размещен макрос

//Событие в локальном модуле может отменить обработку документа
//флПарам -- параметр, передаваемый в модуль обработки документа, может быть изменен функцией OnBeforeDocumentSaveOrPublish
//ФлТип -- если OnBeforeDocumentSaveOrPublish возвратит 0, обработка будет отменена
// 1 -- обработка будет выполнена
// 2 -- обработку выполнила сама функция OnBeforeDocumentSaveOrPublish, выполнять ее здесь не требуется
флПарам:=0;
ФлТип:=0;
If ArgumentsNumber("OnBeforeDocumentSaveOrPublish",1)=2 Then
ФлТип:=Number(ExecuteFunction("OnBeforeDocumentSaveOrPublish",1,1,флПарам));
If ФлТип=0 Then
Exit;
EndIf;
EndIf;

//Далее следует блок обработки документа
If ФлТип<>2 Then
Try
If aEl.Status()<0 Then //Документ необходимо записать, если он новый
aEl.Save();
EndIf;
if not aEl.Publish(флПарам) Then
Exit;
EndIf;
Except
Message(глПодготовитьОшибкуОбработки(),"!");
Exit;
EndTry;
EndIf;

//Событие в локальном модуле может произвести действия, необходимые после обработки документа
If ArgumentsNumber("OnAfterDocumentSaveOrPublish",1)=2 Then
ExecuteFunction("OnAfterDocumentSaveOrPublish",1,1,флПарам);
EndIf;
</pre>

@@ Line 113: / Line 113: @@
 <small>Программа установки, а также бинарные файлы проекта не содержат вирусов, однако при скачивании любых исполняемых файлов из Интернета, всегда рекомендуется использовать антивирус со свежими базами обновлений!</small>
-[http://{{SERVERNAME}}/download/sf_retail_x86_20260401_install.exe <big>'''Скачать файл установки проекта Розница.'''</big>]
+[http://{{SERVERNAME}}/download/sf_retail_x86_20260403_install.exe <big>'''Скачать файл установки проекта Розница.'''</big>]
 ==== Ссылка для скачивания простой демонстрации графических возможностей системы -- tetris.sfo ====