API Basic ByVal

ByVal

ClassicUO • Basic

Параметры передают данные в SUB/FUNCTION. ByRef позволяет записать изменённое значение обратно вызывающему коду; ByVal сохраняет его переменную. Optional задаёт значение при пропуске аргумента, ParamArray принимает оставшиеся аргументы массивом. Это модификаторы объявления, а не отдельные вызываемые команды.

Точный синтаксис

Sub Change(ByVal value)
Function Increment(ByVal value)
Increment(expression)

Параметры

• name / As type — name / As type: Имя параметра и необязательное преобразование входного типа As. Аргументы передаются по позиции либо name:=value; модификаторы записываются в объявлении. См. Basic.NamedArguments.
• ByRef — ByRef: изменяемая переменная или существующий элемент массива/коллекции. Без ByVal параметр этого движка также использует обратную запись; это отличается от значения по умолчанию в VB.NET. Литерал, константа или вычисленное выражение передаются как временное значение.
• ByVal — ByVal: локальная копия значения. Присваивание параметру не меняет переменную вызывающего кода. Массивы и объекты при этом остаются общими ссылками, глубокой копии нет.
• Optional / defaultValue — Optional / defaultValue: аргумент можно не передавать в конце вызова. Выражение после = вычисляется только при пропуске. Всегда указывайте понятное значение по умолчанию; без него пропущенный параметр получает неинициализированное Unit.
• ParamArray — ParamArray values(): последний параметр собирает ноль или больше оставшихся значений. Один переданный массив используется напрямую; список скаляров упаковывается в новый массив. GetArrayLength возвращает его длину.

Возвращает

Модификаторы сами ничего не возвращают. RETURN задаёт результат функции отдельно. Запись через ByRef — изменение аргумента, а не возвращаемое значение; SUB без RETURN возвращает Unit. Числа в примерах — результаты расчёта, не признаки TRUE/FALSE.

Поведение

• При вызове аргументы вычисляются слева направо один раз. Для индексированного ByRef сохраняются контейнер и индекс/ключ; изменение переменной контейнера другим аргументом не перенаправляет эту запись.
• При входе создаются локальные параметры. При выходе, после внутренних FINALLY, значения ByRef записываются обратно по порядку параметров, включая выход из тела по ошибке. Передача одной переменной дважды не создаёт живой связи между двумя локальными параметрами: побеждает последняя обратная запись.
• ByVal запрещает замену переменной вызывающего кода, но не изменение содержимого общего массива или объекта. ReDim локального ByVal-массива создаёт новую локальную ссылку. Для независимых данных нужна явная копия.
• Для позиционных вызовов: Необязательные аргументы пропускаются с конца; пустые места между запятыми не поддерживаются. Значение по умолчанию может быть выражением нашего движка и исполняется при каждом пропуске. Оно не обязано быть константой VB.NET. Позиционные аргументы должны идти первыми; после первого именованного все остальные тоже именованные. Обязательные параметры пропускать нельзя. Пропущенные Optional в процедурах получают объявленные значения по умолчанию: они вычисляются по порядку объявления после переданных выражений. Нативные перегрузки принимают только зарегистрированные имена и количество аргументов, без придуманных значений по умолчанию.
• ParamArray не записывает упакованные скаляры обратно в исходные переменные. Если передан готовый массив, изменение его элементов видно вызывающему коду. Повторная передача массива в другую ParamArray-функцию не создаёт лишний уровень вложенности.
• Пишите ByRef и ByVal явно, чтобы читатель видел намерение. Эти правила относятся к вызовам пользовательских процедур из скрипта; параметры встроенных команд описываются в их собственных карточках.
• ParamArray по имени передавать нельзя. При именованном вызове его можно оставить пустым; для передачи его элементов нужен полностью позиционный вызов. Пустые места между запятыми не поддерживаются. Это подмножество с правилом «позиционные сначала», без свободного смешивания из новых VB.NET. Новые потоки не создаются, игровые задержки не меняются.

Примеры

1. Защита скалярной переменной

# Change получает копию amount=5. Локальное присваивание 99 не меняет внешнюю переменную. Main возвращает Integer 5.
Option Explicit On
Sub Change(ByVal amount)
    amount = 99
End Sub
Sub Main()
    Var amount = 5
    Change(amount)
    Return amount
End Sub

Разбор параметров и выполнения:

Change получает копию amount=5. Локальное присваивание 99 не меняет внешнюю переменную. Main возвращает Integer 5.

2. Общий массив и локальный ReDim

# items передаётся по ByVal, но первый элемент остаётся общим и становится 9. ReDim создаёт другой локальный массив: запись 20 действует только на него. Внешний массив сохраняет длину 1 и элемент 9. Main возвращает Integer 91.
Option Explicit On
Sub Change(ByVal items)
    items[0] = 9
    ReDim items[1]
    items[0] = 20
End Sub
Sub Main()
    Dim items[0]
    items[0] = 4
    Change(items)
    Return items[0] * 10 + GetArrayLength(items)
End Sub

Разбор параметров и выполнения:

items передаётся по ByVal, но первый элемент остаётся общим и становится 9. ReDim создаёт другой локальный массив: запись 20 действует только на него. Внешний массив сохраняет длину 1 и элемент 9. Main возвращает Integer 91.

3. Выражение и отдельный результат

# amount+3 вычисляется в 7. Increment меняет локальное value на 8 и возвращает его. Внешний amount остаётся 4. Main возвращает 4*10+8, Integer 48.
Option Explicit On
Function Increment(ByVal value)
    value += 1
    Return value
End Function
Sub Main()
    Var amount = 4
    Var result = Increment(amount + 3)
    Return amount * 10 + result
End Sub

Разбор параметров и выполнения:

amount+3 вычисляется в 7. Increment меняет локальное value на 8 и возвращает его. Внешний amount остаётся 4. Main возвращает 4*10+8, Integer 48.

---

en · ru · uk · fr · de · it · es · zh-tw · ja · ko

Basic