Общее описание языка - Revision history

Admin: 1 revision imported

2026-04-01T10:01:23Z

1 revision imported

1>Admin: /* Аргументы функции */

2026-01-08T12:53:12Z

‎Аргументы функции

Admin: 1 revision imported

2025-12-27T17:08:49Z

1 revision imported

1>Admin: /* Магические функции */

2025-12-27T11:05:54Z

‎Магические функции

Admin: 1 revision imported

2022-08-09T09:51:08Z

1 revision imported

1>Admin at 08:38, 8 August 2022

2022-08-08T08:38:15Z

Show changes

Admin: 1 revision imported

2022-07-17T11:23:46Z

1 revision imported

1>Admin at 20:22, 6 July 2022

2022-07-06T20:22:55Z

Admin: 1 revision imported

2021-02-07T06:55:22Z

1 revision imported

Admin at 09:19, 28 January 2021

2021-01-28T09:19:54Z

Show changes

@@ Line 326: / Line 326: @@
 * не должно содержать нелитерных и нецифровых знаков. Знаки, которые могут быть использованы в имени функций: "0".."9", "?", "A".."Z", "_", "a".."z", все символы с кодами >=128.
 ===== Аргументы функции =====
-<p>Функция может иметь неограниченное количество аргументов. Свойствами каждого из аргументов являются его имя, способ его адресации и наличие выражения по умолчанию. Имена аргументов подчиняются таким же правилам, как и имена функций. В момент исполнения блока инструкций функции каждый из аргументов может быть адресован по имени, как обычная переменная. Имена аргументов попадают в стек имен последними, при исполнении функции, поэтому, если какое-то имя совпадает с именем переменной с префиксом '''Export''', более высокого уровня вложенности, при обращение к имени будет использован аргумент, а не указанная переменная. Во время вызова функции, аргументы автоматически получают префикс '''Export''', поэтому к ним можно обращаться в функциях более низкого уровня вложенности. При этом, нужно учитывать, что аргументы функции более высокого уровня вложенности будут доступны только в функциях, вложенных в нее. К примеру, функция, вызванная из глобального модуля системы, не сможет получить доступ к аргументам, вызывающей функции, находящейся в другом модуле.</p>
+<p>Функция может иметь неограниченное количество аргументов. Свойствами каждого из аргументов являются его имя, способ его адресации и наличие выражения по умолчанию. Имена аргументов подчиняются таким же правилам, как и имена функций. В момент исполнения блока инструкций функции каждый из аргументов может быть адресован по имени, как обычная переменная. Имена аргументов попадают в стек имен последними, при исполнении функции, поэтому, если какое-то имя совпадает с именем переменной с префиксом '''Export''', более высокого уровня вложенности, при обращение к имени будет использован аргумент, а не указанная переменная. Во время вызова функции, к аргументам можно обращаться в функциях более низкого уровня вложенности того же самого модуля (т.е. функция, вызываемая, к примеру, из глобального модуля, не будет видеть аргумент вызывающей функции, находящейся в другом модуле). Иными словами, аргументы функции более высокого уровня вложенности будут доступны только в функциях, вложенных в нее. Агрументы функций можно сделать видимыми из вызываемых функций любого уровня вложенности и любого модуля, если использовать префикс '''Export'''. В этом отношении, они будут подобны переменным с таким префиксом.</p>
-<p>Способ адресации аргумента определяет возможность изменения внешней переменной или метода объекта из тела самой функции. Существует два способа адресации аргументов:
+<p>Способ адресации аргумента определяет возможность изменения внешней переменной или метода объекта из тела самой функции, а также видимость этого аргумента в вызываемых функциях. Существует два вида адресации аргументов. Оба можно использовать при задании аргументов одновременно (т.е. разрешены комбинации <code>ByRef Export</code>, <code>Export ByVal</code> и т.п.):
-* '''ByVal''', используемый по умолчанию, когда при изменении аргументов внутри функции, внешние переменные не будут изменены (однако, нужно учесть, что, если переменная содержит объект, то аргумент будет содержать тот же самый объект и изменения, производимые в объекте при его адресации с помощью аргумента, будут также видны при его адресации с помощью внешней переменной, пример см. ниже).
+* Правила изменения аргумента-переменной. Можно использовать один из указанных префиксов:
-* '''ByRef''', при задании адресации таким способом, после окончания выполнения функции, переменная, использовавшаяся при вызове функции, будет обновлена значением аргумента. Важно понимать, что обновление значения переменных не происходит при каждом изменении аргумента, а только один раз после окончания выполнения функции (пример см. ниже)</p>
+** '''ByVal''', используемый по умолчанию, когда при изменении аргументов внутри функции, внешние переменные не будут изменены (однако, нужно учесть, что, если переменная содержит объект, то аргумент будет содержать тот же самый объект и изменения, производимые в объекте при его адресации с помощью аргумента, будут также видны при его адресации с помощью внешней переменной, пример см. ниже).
 <p>При определении аргумента можно также использовать дополнительное выражение, называемое выражением по умолчанию. Если выражение по умолчанию определено, аргумент считается необязательным, его указание при вызове функции не требуется, к примеру для функции <code>Func</code> с аргументами <code>Func(a,b=1,c=2)</code> аргументы b и с можно опустить, при пропуске только переменной ''b'', можно осуществить вызов функции в виде, к примеру, <code>Func(1,,3)</code>, при пропуске только переменной ''c'', функцию можно вызвать, к примеру, <code>Func(1,2)</code>, при пропуске же обоих аргументов функцию можно вызвать просто как <code>Func(2)</code>. Выражение, указываемое при определении аргумента, будет использоваться для его инициализации при вызове функции без указания аргумента. Выражения могут быть как простыми константами, так как сложными выражениями с использованием математических, логических функций и даже вызовов других функций объявленных в тексте программы. В случаях сложных выражений их вычисление происходит в момент вызова функции при помещении аргументов в стек переменных до исполнения блока инструкций самой функции.</p>
 Синтетический пример, показывающий инициализацию и работу с функциями, содержащими разные типы аргументов:
@@ Line 521: / Line 525: @@
 ==== Магические функции ====
-Магическими называются функции, нестандартная работа с аргументами которых, не позволяет создать их обычными средствами языка. Для обычных функций каждый из аргументов вычисляется до того, как будет произведено обращение к функции, тогда как магические функции работают как конструкции языка с блоками инструкций, и вычисления аргументов производятся только когда это необходимо. В отличие от конструкций языка, однако, магические функции не могут представлять самостоятельные инструкции или содержать блоки инструкций, а используются только в выражениях и могут содержать только выражения в своих аргументах. Кроме описанных здесь магических функций, существуют и другие (к примеру, [[Coalesce]], [[InSet]], [[InRange]], [[If2|??]] и т.д.), они помечены как магические в описании и в списке функций.
+Магическими называются функции, нестандартная работа с аргументами которых, не позволяет создать их обычными средствами языка. Для обычных функций каждый из аргументов вычисляется до того, как будет произведено обращение к функции, тогда как магические функции работают как конструкции языка с блоками инструкций, и вычисления аргументов производятся только когда это необходимо. В отличие от конструкций языка, однако, магические функции не могут представлять самостоятельные инструкции или содержать блоки инструкций, а используются только в выражениях и могут содержать только выражения в своих аргументах. Кроме описанных здесь магических функций, существуют и другие (к примеру, [[Coalesce]], [[InSet]], [[InRange]], [[If2|??]] и т.д.), они помечены как магические в описании и в списке функций. Эти функции, в отличие от описанных здесь, могут использоваться не только в выражениях, но и как самостоятельные инструкции (к примеру, <code>?(pos("code",Стр)>0,TearStr(Стр,"code"),TearStr(Стр,","));</code> вызовет ошибку без оператора присваивания, однако использование <code>??(pos("code",Стр)>0,TearStr(Стр,"code"),TearStr(Стр,","));</code> допустимо). {{Planned}} Все функции, описанные здесь, в будущем можно будет использовать, как самостоятельные инструкции.
 ===== Магическая функция логическое "и" =====

@@ Line 521: / Line 521: @@
 ==== Магические функции ====
-Магическими называются функции, нестандартная работа с аргументами которых, не позволяет создать их обычными средствами языка. Для обычных функций каждый из аргументов вычисляется до того, как будет произведено обращение к функции, тогда как магические функции работают как конструкции языка с блоками инструкций, и вычисления аргументов производятся только когда это необходимо. В отличие от конструкций языка, однако, магические функции не могут представлять самостоятельные инструкции или содержать блоки инструкций, а используются только в выражениях и могут содержать только выражения в своих аргументах.
+Магическими называются функции, нестандартная работа с аргументами которых, не позволяет создать их обычными средствами языка. Для обычных функций каждый из аргументов вычисляется до того, как будет произведено обращение к функции, тогда как магические функции работают как конструкции языка с блоками инструкций, и вычисления аргументов производятся только когда это необходимо. В отличие от конструкций языка, однако, магические функции не могут представлять самостоятельные инструкции или содержать блоки инструкций, а используются только в выражениях и могут содержать только выражения в своих аргументах. Кроме описанных здесь магических функций, существуют и другие (к примеру, [[Coalesce]], [[InSet]], [[InRange]], [[If2|??]] и т.д.), они помечены как магические в описании и в списке функций.
 ===== Магическая функция логическое "и" =====

@@ Line 329: / Line 329: @@
 <p>Способ адресации аргумента определяет возможность изменения внешней переменной или метода объекта из тела самой функции. Существует два способа адресации аргументов:
 * '''ByVal''', используемый по умолчанию, когда при изменении аргументов внутри функции, внешние переменные не будут изменены (однако, нужно учесть, что, если переменная содержит объект, то аргумент будет содержать тот же самый объект и изменения, производимые в объекте при его адресации с помощью аргумента, будут также видны при его адресации с помощью внешней переменной, пример см. ниже).
-* '''ByRef''', при задании адресации таким способом, после окончании выполнения функции, переменная, использовавшаяся при вызове функции, будет обновлена значением аргумента. Кроме переменных, возможно также обновление свойств объектов. Важно понимать, что обновление значения переменных или свойств объектов не происходит при каждом изменении аргумента, а только один раз после окончания выполнения функции (пример см. ниже)</p>
+* '''ByRef''', при задании адресации таким способом, после окончании выполнения функции, переменная, использовавшаяся при вызове функции, будет обновлена значением аргумента. Важно понимать, что обновление значения переменных не происходит при каждом изменении аргумента, а только один раз после окончания выполнения функции (пример см. ниже)</p>
 <p>При определении аргумента можно также использовать дополнительное выражение, называемое выражением по умолчанию. Если выражение по умолчанию определено, аргумент считается необязательным, его указание при вызове функции не требуется, к примеру для функции <code>Func</code> с аргументами <code>Func(a,b=1,c=2)</code> аргументы b и с можно опустить, при пропуске только переменной ''b'', можно осуществить вызов функции в виде, к примеру, <code>Func(1,,3)</code>, при пропуске только переменной ''c'', функцию можно вызвать, к примеру, <code>Func(1,2)</code>, при пропуске же обоих аргументов функцию можно вызвать просто как <code>Func(2)</code>. Выражение, указываемое при определении аргумента, будет использоваться для его инициализации при вызове функции без указания аргумента. Выражения могут быть как простыми константами, так как сложными выражениями с использованием математических, логических функций и даже вызовов других функций объявленных в тексте программы. В случаях сложных выражений их вычисление происходит в момент вызова функции при помещении аргументов в стек переменных до исполнения блока инструкций самой функции.</p>
 Синтетический пример, показывающий инициализацию и работу с функциями, содержащими разные типы аргументов:
@@ Line 365: / Line 365: @@
 Функ1(aTab.Значение,(Пер2),0);&#9;&#9;&#9;&#9;//Произойдет вывод "Вызов осуществлен с аргументами: 0, 0, 0"
 Message(Пер2);&#9;&#9;&#9;&#9;&#9;&#9;//Будет выведено число 0, так аргументом вызова функции была не переменная, а выражение "(Пер2)"
-Message(aTab.Значение);&#9;&#9;&#9;&#9;&#9;//Будет выведено число 1 (функция изменила аргумент, что в свою очередь изменило значение столбца таблицы)
+Message(aTab.Значение);&#9;&#9;&#9;&#9;&#9;//Будет выведено число 0
-//Замечание: по окончании вызова Функ1 была выполнена операция, результат которой аналогичен исполнению выражения aTab.Значение:=ПерА;
+//Изменения внутри функции транслируются только на переменные, но не на свойства объектов, так как это может создавать скрытые ошибки, которые тяжело будет найти:
 </pre>

← Older revision	Revision as of 10:01, 1 April 2026
(No difference)

← Older revision	Revision as of 17:08, 27 December 2025
(No difference)

← Older revision	Revision as of 09:51, 9 August 2022
(No difference)

← Older revision	Revision as of 11:23, 17 July 2022
(No difference)

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