API UO CallSub

UO.CallSub

ClassicUO / Basic IDE

Оглавление · Алфавитный указатель · Scripts & Runtime

Передаёт имя процедуры менеджеру скриптов для запуска. Процедура должна быть доступна клиенту; существование можно проверить SubExists. Не принимает тело программы вместо имени.

Синтаксис

UO.CallSub(subrutineName:String) -> Unit

Регистр имени не важен. Any — динамическое значение Basic; Unit — отсутствие возвращаемого значения. Integer — знаковое 32-битное число, Decimal — число с плавающей точкой. Правила типов, serial, индексов и ожиданий.

Параметры

Имя	Назначение
subrutineName	Позиционный аргумент этой перегрузки. Подробности использования указаны в описании/фактической ветви runtime ниже.

Параметры обязательны внутри каждой показанной сигнатуры. Опустить аргумент можно только при наличии более короткой перегрузки; пропуск позиции посередине не подразумевается.

Возвращает: Unit — значения нет. Выполняйте вызов отдельной строкой; его нельзя использовать как проверку успеха. Эффект и ограничения зависят от команды.

Примеры

Каждый блок — самостоятельный скрипт из мануала проекта. Параметры демонстрационного объекта/контейнера и условия действия необходимо сопоставить с вашей игровой ситуацией.

Пример 1

SUB Main()
    UO.CallSub('example')
END SUB

Пример 2

SUB Main()
    IF UO.Connected THEN
        VAR arg1 = 'example' # subrutineName
        UO.CallSub(arg1)
    END IF
END SUB

Пример 3

SUB RunAction()
    VAR arg1 = 'example' # subrutineName
    UO.CallSub(arg1)
END SUB

SUB Main()
    # Запуск процедуры выполняет действие:
    RunAction()
END SUB

Реализация и проверка контракта

• InjectionScript.Runtime.InjectionApiUO.CallSub

Источник реестра и отчёт сверки. Примеры проверяются загрузчиком/парсером включённого runtime. Действия на игровом сервере этой проверкой не исполняются.