API UO FindList - LIHACHTETAN/ClassicUO-BadNewbie-BasicIDE GitHub Wiki

UO.FindList

ClassicUO / Basic IDE

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

Resolves the named list created in runtime state, then executes the same Search Core used by FindType/FindNotoriety. The list name is not treated as a numeric type string.

Синтаксис

UO.FindList(list:Any) -> String
UO.FindList(list:Any, container:Any) -> String
UO.FindList(list:Any, container:Any, distance:Any) -> String
UO.FindList(list:Any, container:Any, distance:Any, notoriety:Any) -> String
UO.FindList(list:Any, container:Any, distance:Any, notoriety:Any, nearest:Any) -> String
UO.FindList(list:Any, container:Any, distance:Any, notoriety:Any, nearest:Any, maxZ:Any) -> String
UO.FindList(list:Any, container:Any, distance:Any, notoriety:Any, nearest:Any, maxZ:Any, includeIgnored:Any) -> String

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

Параметры

Имя Назначение
list Позиционный аргумент этой перегрузки. Подробности использования указаны в описании/фактической ветви runtime ниже.
container Container/object destination. Use backpack/ground/self/saved object name or a valid hexadecimal/decimal serial where that overload permits it.
distance Позиционный аргумент этой перегрузки. Подробности использования указаны в описании/фактической ветви runtime ниже.
notoriety Notoriety code: 0 unknown, 1 blue, 2 green, 3 attackable grey, 4 criminal grey, 5 orange enemy, 6 red murderer, 7 invulnerable yellow.
nearest Boolean-like runtime value: TRUE/1 enables the option and FALSE/0 disables it unless the command documents another numeric mode.
maxZ Позиционный аргумент этой перегрузки. Подробности использования указаны в описании/фактической ветви runtime ниже.
includeIgnored Позиционный аргумент этой перегрузки. Подробности использования указаны в описании/фактической ветви runtime ниже.

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

Ограничения

The named list must exist in runtime state. Missing/empty lists produce the documented no-match result instead of inventing a type from the list name.

Примеры

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

Пример 1

SUB Main()
    VAR result = UO.FindList(0)
END SUB

Пример 2

SUB Main()
    VAR result = UO.FindList(0, 0, 0, 0, 0)
END SUB

Пример 3

SUB Main()
    VAR result = UO.FindList(1)
    UO.Print(CStr(result))
END SUB

Пример 4

SUB Main()
    VAR arg1 = 1 # list
    VAR arg2 = backpack # container
    VAR arg3 = 5 # distance
    VAR arg4 = -1 # notoriety
    VAR arg5 = 1 # nearest
    VAR arg6 = 6 # maxZ
    VAR arg7 = 7 # includeIgnored
    VAR result = UO.FindList(arg1, arg2, arg3, arg4, arg5, arg6, arg7)
    UO.Print(CStr(result))
END SUB

Пример 5

SUB Main()
    VAR result = UO.FindList(1, backpack)
    UO.Print(CStr(result))
END SUB

Пример 6

SUB Main()
    VAR result = UO.FindList(1, backpack, 5)
    UO.Print(CStr(result))
END SUB

Пример 7

SUB Main()
    VAR result = UO.FindList(1, backpack, 5, -1)
    UO.Print(CStr(result))
END SUB

Пример 8

SUB Main()
    VAR result = UO.FindList(1, backpack, 5, -1, 1)
    UO.Print(CStr(result))
END SUB

Пример 9

SUB Main()
    VAR result = UO.FindList(1, backpack, 5, -1, 1, 6)
    UO.Print(CStr(result))
END SUB

Пример 10

SUB Main()
    VAR arg1 = 1 # list
    VAR result = UO.FindList(arg1)
    IF len(result) > 0 THEN
        UO.Print(result)
    ELSE
        UO.Print('Empty')
    END IF
END SUB

Пример 11

SUB Main()
    VAR arg1 = 1 # list
    VAR result = UO.FindList(arg1)
    IF contains(LCase(result), 'example') THEN
        UO.Print('Match')
    END IF
END SUB
Реализация и проверка контракта
  • InjectionScript.Runtime.InjectionApiUO.<Register>b__37_15

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

⚠️ **GitHub.com Fallback** ⚠️